<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qwidget.cpp -->
  <title>QWidget 类 | Qt Widgets 5.12.3</title>
  <link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
  <script type="text/javascript">
    document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
    // loading style sheet breaks anchors that were jumped to before
    // so force jumping to anchor again
    setTimeout(function() {
        var anchor = location.hash;
        // need to jump to different anchor first (e.g. none)
        location.hash = "#";
        setTimeout(function() {
            location.hash = anchor;
        }, 0);
    }, 0);
  </script>
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="main">
    <div class="main-rounded">
      <div class="navigationbar">
        <table><tr>
<td ><a href="../qtdoc/index.html">Qt 5.12</a></td><td ><a href="qtwidgets-index.html">Qt Widgets</a></td><td ><a href="qtwidgets-module.html">C++ 类</a></td><td >QWidget</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right"><a href="qtwidgets-index.html">
Qt 5.12.3 <span lang="zh-cn">参考指南</span></a></td>
        </tr></table>
      </div>
    </div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><span lang="zh-cn">目录</span></h3>
<ul>
<li class="level1"><a href="#public-types"><span lang="zh-cn">功用类型</span></a></li>
<li class="level1"><a href="#properties"><span lang="zh-cn">属性</span></a></li>
<li class="level1"><a href="#public-functions"><span lang="zh-cn">公用函数</span></a></li>
<li class="level1"><a href="#reimplemented-public-functions"><span lang="zh-cn">
重新实现的功用函数</span></a></li>
<li class="level1"><a href="#public-slots"><span lang="zh-cn">公用槽</span></a></li>
<li class="level1"><a href="#signals"><span lang="zh-cn">信号</span></a></li>
<li class="level1"><a href="#static-public-members"><span lang="zh-cn">静态共用成员</span></a></li>
<li class="level1"><a href="#protected-functions"><span lang="zh-cn">保护函数</span></a></li>
<li class="level1"><a href="#reimplemented-protected-functions">
<span lang="zh-cn">重新实现的保护函数</span></a></li>
<li class="level1"><a href="#protected-slots"><span lang="zh-cn">保护槽</span></a></li>
<li class="level1"><a href="#macros"><span lang="zh-cn">宏</span></a></li>
<li class="level1"><a href="#details"><span lang="zh-cn">详细信息</span></a></li>
<li class="level2"><a href="#top-level-and-child-widgets"><span lang="zh-cn">
顶级组件和子组件</span></a></li>
<li class="level2"><a href="#composite-widgets"><span lang="zh-cn">组合组件</span></a></li>
<li class="level2"><a href="#custom-widgets-and-painting">自定义<span lang="zh-cn">组件</span>和<span lang="zh-cn">绘制</span></a></li>
<li class="level2"><a href="#size-hints-and-size-policies">大小提示和大小策略</a></li>
<li class="level2"><a href="#events"><span lang="zh-cn">事件</span></a></li>
<li class="level2"><a href="#groups-of-functions-and-properties">函数和属性组</a></li>
<li class="level2"><a href="#widget-style-sheets"><span lang="zh-cn">组件样式表</span></a></li>
<li class="level2"><a href="#transparency-and-double-buffering">透明和双重缓冲</a></li>
<li class="level2"><a href="#creating-translucent-windows">创建半透明的窗口</a></li>
<li class="level2"><a href="#native-widgets-vs-alien-widgets">本地组件<span lang="zh-cn">vs</span>外来组件</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">QWidget <span lang="zh-cn">类</span></h1>
<!-- $$$QWidget-brief -->
<p><a href="qwidget.html">QWidget</a>类是所有用户界面对象的基类。 <a href="#details">
<span lang="zh-cn">更多</span>...</a></p>
<!-- @@@QWidget -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> <span lang="zh-cn">头文件</span>:</td><td class="memItemRight bottomAlign">   <span class="preprocessor">#include &lt;QWidget&gt;</span>
</td></tr><tr><td class="memItemLeft rightAlign topAlign"> qmake:</td><td class="memItemRight bottomAlign"> QT += widgets</td></tr><tr><td class="memItemLeft rightAlign topAlign"> 
	<span lang="zh-cn">继承自</span>:</td><td class="memItemRight bottomAlign"> <a href="../qtcore/qobject.html">QObject</a> 
	<span lang="zh-cn">和 </span><a href="../qtgui/qpaintdevice.html">QPaintDevice</a></td></tr><tr><td class="memItemLeft rightAlign topAlign"> 
		<span lang="zh-cn">被继承</span>:</td><td class="memItemRight bottomAlign"> <p><a href="qabstractbutton.html">QAbstractButton</a>, <a href="qabstractslider.html">QAbstractSlider</a>, <a href="qabstractspinbox.html">QAbstractSpinBox</a>, <a href="qcalendarwidget.html">QCalendarWidget</a>, <a href="qcombobox.html">QComboBox</a>, <a href="qdesktopwidget.html" class="obsolete">QDesktopWidget</a>, <a href="qdialog.html">QDialog</a>, <a href="qdialogbuttonbox.html">QDialogButtonBox</a>, <a href="qdockwidget.html">QDockWidget</a>, <a href="qfocusframe.html">QFocusFrame</a>, <a href="qframe.html">QFrame</a>, <a href="qgroupbox.html">QGroupBox</a>, <a href="qkeysequenceedit.html">QKeySequenceEdit</a>, <a href="qlineedit.html">QLineEdit</a>, <a href="qmainwindow.html">QMainWindow</a>, <a href="qmdisubwindow.html">QMdiSubWindow</a>, <a href="qmenu.html">QMenu</a>, <a href="qmenubar.html">QMenuBar</a>, <a href="qopenglwidget.html">QOpenGLWidget</a>, <a href="qprogressbar.html">QProgressBar</a>, <a href="qrubberband.html">QRubberBand</a>, <a href="qsizegrip.html">QSizeGrip</a>, <a href="qsplashscreen.html">QSplashScreen</a>, <a href="qsplitterhandle.html">QSplitterHandle</a>, <a href="qstatusbar.html">QStatusBar</a>, <a href="qtabbar.html">QTabBar</a>, <a href="qtabwidget.html">QTabWidget</a>, <a href="qtoolbar.html">QToolBar</a>, and <a href="qwizardpage.html">QWizardPage</a></p>
</td></tr></table></div><ul>
<li><a href="qwidget-members.html">所有成员的列表，包括继承成员</a></li>
<li><a href="qwidget-obsolete.html"><span lang="zh-cn">废弃</span>的成员</a></li>
</ul>
<a name="public-types"></a>
<h2 id="public-types"><span lang="zh-cn">功用类型</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#RenderFlag-enum">RenderFlag</a></b> { DrawWindowBackground, DrawChildren, IgnoreMask }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#RenderFlag-enum">RenderFlags</a></b></td></tr>
</table></div>
<a name="properties"></a>
<h2 id="properties"><span lang="zh-cn">属性</span></h2>
<div class="table"><table class="propsummary">
<tr><td class="topAlign"><ul>
<li class="fn"><b><a href="qwidget.html#acceptDrops-prop">acceptDrops</a></b> : bool</li>
<li class="fn"><b><a href="qwidget.html#accessibleDescription-prop">accessibleDescription</a></b> : QString</li>
<li class="fn"><b><a href="qwidget.html#accessibleName-prop">accessibleName</a></b> : QString</li>
<li class="fn"><b><a href="qwidget.html#autoFillBackground-prop">autoFillBackground</a></b> : bool</li>
<li class="fn"><b><a href="qwidget.html#baseSize-prop">baseSize</a></b> : QSize</li>
<li class="fn"><b><a href="qwidget.html#childrenRect-prop">childrenRect</a></b> : const QRect</li>
<li class="fn"><b><a href="qwidget.html#childrenRegion-prop">childrenRegion</a></b> : const QRegion</li>
<li class="fn"><b><a href="qwidget.html#contextMenuPolicy-prop">contextMenuPolicy</a></b> : Qt::ContextMenuPolicy</li>
<li class="fn"><b><a href="qwidget.html#cursor-prop">cursor</a></b> : QCursor</li>
<li class="fn"><b><a href="qwidget.html#enabled-prop">enabled</a></b> : bool</li>
<li class="fn"><b><a href="qwidget.html#focus-prop">focus</a></b> : const bool</li>
<li class="fn"><b><a href="qwidget.html#focusPolicy-prop">focusPolicy</a></b> : Qt::FocusPolicy</li>
<li class="fn"><b><a href="qwidget.html#font-prop">font</a></b> : QFont</li>
<li class="fn"><b><a href="qwidget.html#frameGeometry-prop">frameGeometry</a></b> : const QRect</li>
<li class="fn"><b><a href="qwidget.html#frameSize-prop">frameSize</a></b> : const QSize</li>
<li class="fn"><b><a href="qwidget.html#fullScreen-prop">fullScreen</a></b> : const bool</li>
<li class="fn"><b><a href="qwidget.html#geometry-prop">geometry</a></b> : QRect</li>
<li class="fn"><b><a href="qwidget.html#height-prop">height</a></b> : const int</li>
<li class="fn"><b><a href="qwidget.html#inputMethodHints-prop">inputMethodHints</a></b> : Qt::InputMethodHints</li>
<li class="fn"><b><a href="qwidget.html#isActiveWindow-prop">isActiveWindow</a></b> : const bool</li>
<li class="fn"><b><a href="qwidget.html#layoutDirection-prop">layoutDirection</a></b> : Qt::LayoutDirection</li>
<li class="fn"><b><a href="qwidget.html#locale-prop">locale</a></b> : QLocale</li>
<li class="fn"><b><a href="qwidget.html#maximized-prop">maximized</a></b> : const bool</li>
<li class="fn"><b><a href="qwidget.html#maximumHeight-prop">maximumHeight</a></b> : int</li>
<li class="fn"><b><a href="qwidget.html#maximumSize-prop">maximumSize</a></b> : QSize</li>
<li class="fn"><b><a href="qwidget.html#maximumWidth-prop">maximumWidth</a></b> : int</li>
<li class="fn"><b><a href="qwidget.html#minimized-prop">minimized</a></b> : const bool</li>
<li class="fn"><b><a href="qwidget.html#minimumHeight-prop">minimumHeight</a></b> : int</li>
<li class="fn"><b><a href="qwidget.html#minimumSize-prop">minimumSize</a></b> : QSize</li>
<li class="fn"><b><a href="qwidget.html#minimumSizeHint-prop">minimumSizeHint</a></b> : const QSize</li>
</ul></td><td class="topAlign"><ul>
<li class="fn"><b><a href="qwidget.html#minimumWidth-prop">minimumWidth</a></b> : int</li>
<li class="fn"><b><a href="qwidget.html#modal-prop">modal</a></b> : const bool</li>
<li class="fn"><b><a href="qwidget.html#mouseTracking-prop">mouseTracking</a></b> : bool</li>
<li class="fn"><b><a href="qwidget.html#normalGeometry-prop">normalGeometry</a></b> : const QRect</li>
<li class="fn"><b><a href="qwidget.html#palette-prop">palette</a></b> : QPalette</li>
<li class="fn"><b><a href="qwidget.html#pos-prop">pos</a></b> : QPoint</li>
<li class="fn"><b><a href="qwidget.html#rect-prop">rect</a></b> : const QRect</li>
<li class="fn"><b><a href="qwidget.html#size-prop">size</a></b> : QSize</li>
<li class="fn"><b><a href="qwidget.html#sizeHint-prop">sizeHint</a></b> : const QSize</li>
<li class="fn"><b><a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a></b> : QSize</li>
<li class="fn"><b><a href="qwidget.html#sizePolicy-prop">sizePolicy</a></b> : QSizePolicy</li>
<li class="fn"><b><a href="qwidget.html#statusTip-prop">statusTip</a></b> : QString</li>
<li class="fn"><b><a href="qwidget.html#styleSheet-prop">styleSheet</a></b> : QString</li>
<li class="fn"><b><a href="qwidget.html#tabletTracking-prop">tabletTracking</a></b> : bool</li>
<li class="fn"><b><a href="qwidget.html#toolTip-prop">toolTip</a></b> : QString</li>
<li class="fn"><b><a href="qwidget.html#toolTipDuration-prop">toolTipDuration</a></b> : int</li>
<li class="fn"><b><a href="qwidget.html#updatesEnabled-prop">updatesEnabled</a></b> : bool</li>
<li class="fn"><b><a href="qwidget.html#visible-prop">visible</a></b> : bool</li>
<li class="fn"><b><a href="qwidget.html#whatsThis-prop">whatsThis</a></b> : QString</li>
<li class="fn"><b><a href="qwidget.html#width-prop">width</a></b> : const int</li>
<li class="fn"><b><a href="qwidget.html#windowFilePath-prop">windowFilePath</a></b> : QString</li>
<li class="fn"><b><a href="qwidget.html#windowFlags-prop">windowFlags</a></b> : Qt::WindowFlags</li>
<li class="fn"><b><a href="qwidget.html#windowIcon-prop">windowIcon</a></b> : QIcon</li>
<li class="fn"><b><a href="qwidget.html#windowModality-prop">windowModality</a></b> : Qt::WindowModality</li>
<li class="fn"><b><a href="qwidget.html#windowModified-prop">windowModified</a></b> : bool</li>
<li class="fn"><b><a href="qwidget.html#windowOpacity-prop">windowOpacity</a></b> : double</li>
<li class="fn"><b><a href="qwidget.html#windowTitle-prop">windowTitle</a></b> : QString</li>
<li class="fn"><b><a href="qwidget.html#x-prop">x</a></b> : const int</li>
<li class="fn"><b><a href="qwidget.html#y-prop">y</a></b> : const int</li>
</ul>
</td></tr>
</table></div>
<ul>
<li class="fn">1 个属性继承自<a href="../qtcore/qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h2 id="public-functions"><span lang="zh-cn">公用函数</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#QWidget">QWidget</a></b>(QWidget *<i>parent</i> = nullptr, Qt::WindowFlags <i>f</i> = ...)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#dtor.QWidget">~QWidget</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#acceptDrops-prop">acceptDrops</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#accessibleDescription-prop">accessibleDescription</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#accessibleName-prop">accessibleName</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QAction *&gt; </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#actions">actions</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#activateWindow">activateWindow</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#addAction">addAction</a></b>(QAction *<i>action</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#addActions">addActions</a></b>(QList&lt;QAction *&gt; <i>actions</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#adjustSize">adjustSize</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#autoFillBackground-prop">autoFillBackground</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPalette::ColorRole </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#backgroundRole">backgroundRole</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QBackingStore *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#backingStore">backingStore</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QSize </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#baseSize-prop">baseSize</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#childAt">childAt</a></b>(int <i>x</i>, int <i>y</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#childAt-1">childAt</a></b>(const QPoint &amp;<i>p</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#childrenRect-prop">childrenRect</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRegion </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#childrenRegion-prop">childrenRegion</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#clearFocus">clearFocus</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#clearMask">clearMask</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMargins </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#contentsMargins">contentsMargins</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#contentsRect">contentsRect</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Qt::ContextMenuPolicy </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#contextMenuPolicy-prop">contextMenuPolicy</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QCursor </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#cursor-prop">cursor</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> WId </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#effectiveWinId">effectiveWinId</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#ensurePolished">ensurePolished</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Qt::FocusPolicy </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusPolicy-prop">focusPolicy</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusProxy">focusProxy</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusWidget">focusWidget</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QFont &amp;</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#font-prop">font</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QFontInfo </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#fontInfo">fontInfo</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QFontMetrics </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#fontMetrics">fontMetrics</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPalette::ColorRole </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#foregroundRole">foregroundRole</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#frameGeometry-prop">frameGeometry</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QSize </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#frameSize-prop">frameSize</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QRect &amp;</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#geometry-prop">geometry</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#getContentsMargins">getContentsMargins</a></b>(int *<i>left</i>, int *<i>top</i>, int *<i>right</i>, int *<i>bottom</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPixmap </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#grab">grab</a></b>(const QRect &amp;<i>rectangle</i> = QRect(QPoint(0, 0), QSize(-1, -1)))</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#grabGesture">grabGesture</a></b>(Qt::GestureType <i>gesture</i>, Qt::GestureFlags <i>flags</i> = ...)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#grabKeyboard">grabKeyboard</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#grabMouse">grabMouse</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#grabMouse-1">grabMouse</a></b>(const QCursor &amp;<i>cursor</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#grabShortcut">grabShortcut</a></b>(const QKeySequence &amp;<i>key</i>, Qt::ShortcutContext <i>context</i> = Qt::WindowShortcut)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGraphicsEffect *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#graphicsEffect">graphicsEffect</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QGraphicsProxyWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#graphicsProxyWidget">graphicsProxyWidget</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#hasEditFocus">hasEditFocus</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focus-prop">hasFocus</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#hasHeightForWidth">hasHeightForWidth</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mouseTracking-prop">hasMouseTracking</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#tabletTracking-prop">hasTabletTracking</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#height-prop">height</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#heightForWidth">heightForWidth</a></b>(int <i>w</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Qt::InputMethodHints </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#inputMethodHints-prop">inputMethodHints</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QVariant </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#inputMethodQuery">inputMethodQuery</a></b>(Qt::InputMethodQuery <i>query</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#insertAction">insertAction</a></b>(QAction *<i>before</i>, QAction *<i>action</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#insertActions">insertActions</a></b>(QAction *<i>before</i>, QList&lt;QAction *&gt; <i>actions</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#isActiveWindow-prop">isActiveWindow</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#isAncestorOf">isAncestorOf</a></b>(const QWidget *<i>child</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#enabled-prop">isEnabled</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#isEnabledTo">isEnabledTo</a></b>(const QWidget *<i>ancestor</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#fullScreen-prop">isFullScreen</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#isHidden">isHidden</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#maximized-prop">isMaximized</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#minimized-prop">isMinimized</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#modal-prop">isModal</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#visible-prop">isVisible</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#isVisibleTo">isVisibleTo</a></b>(const QWidget *<i>ancestor</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#isWindow">isWindow</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowModified-prop">isWindowModified</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QLayout *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#layout">layout</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Qt::LayoutDirection </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#layoutDirection-prop">layoutDirection</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QLocale </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#locale-prop">locale</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mapFrom">mapFrom</a></b>(const QWidget *<i>parent</i>, const QPoint &amp;<i>pos</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mapFromGlobal">mapFromGlobal</a></b>(const QPoint &amp;<i>pos</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mapFromParent">mapFromParent</a></b>(const QPoint &amp;<i>pos</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mapTo">mapTo</a></b>(const QWidget *<i>parent</i>, const QPoint &amp;<i>pos</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mapToGlobal">mapToGlobal</a></b>(const QPoint &amp;<i>pos</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mapToParent">mapToParent</a></b>(const QPoint &amp;<i>pos</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRegion </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mask">mask</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#maximumHeight-prop">maximumHeight</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QSize </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#maximumSize-prop">maximumSize</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#maximumWidth-prop">maximumWidth</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#minimumHeight-prop">minimumHeight</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QSize </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#minimumSize-prop">minimumSize</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QSize </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#minimumSizeHint-prop">minimumSizeHint</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#minimumWidth-prop">minimumWidth</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#pos-prop">move</a></b>(<i>const QPoint &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#move-1">move</a></b>(int <i>x</i>, int <i>y</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#nativeParentWidget">nativeParentWidget</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#nextInFocusChain">nextInFocusChain</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#normalGeometry-prop">normalGeometry</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#overrideWindowFlags">overrideWindowFlags</a></b>(Qt::WindowFlags <i>flags</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QPalette &amp;</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#palette-prop">palette</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#parentWidget">parentWidget</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPoint </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#pos-prop">pos</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#previousInFocusChain">previousInFocusChain</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#rect-prop">rect</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#releaseKeyboard">releaseKeyboard</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#releaseMouse">releaseMouse</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#releaseShortcut">releaseShortcut</a></b>(int <i>id</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#removeAction">removeAction</a></b>(QAction *<i>action</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#render">render</a></b>(QPaintDevice *<i>target</i>, const QPoint &amp;<i>targetOffset</i> = QPoint(), const QRegion &amp;<i>sourceRegion</i> = QRegion(), QWidget::RenderFlags <i>renderFlags</i> = ...)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#render-1">render</a></b>(QPainter *<i>painter</i>, const QPoint &amp;<i>targetOffset</i> = QPoint(), const QRegion &amp;<i>sourceRegion</i> = QRegion(), QWidget::RenderFlags <i>renderFlags</i> = ...)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#repaint-1">repaint</a></b>(int <i>x</i>, int <i>y</i>, int <i>w</i>, int <i>h</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#repaint-2">repaint</a></b>(const QRect &amp;<i>rect</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#repaint-3">repaint</a></b>(const QRegion &amp;<i>rgn</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#size-prop">resize</a></b>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#resize-1">resize</a></b>(int <i>w</i>, int <i>h</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#restoreGeometry">restoreGeometry</a></b>(const QByteArray &amp;<i>geometry</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#saveGeometry">saveGeometry</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#scroll">scroll</a></b>(int <i>dx</i>, int <i>dy</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#scroll-1">scroll</a></b>(int <i>dx</i>, int <i>dy</i>, const QRect &amp;<i>r</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#acceptDrops-prop">setAcceptDrops</a></b>(bool <i>on</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#accessibleDescription-prop">setAccessibleDescription</a></b>(const QString &amp;<i>description</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#accessibleName-prop">setAccessibleName</a></b>(const QString &amp;<i>name</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setAttribute">setAttribute</a></b>(Qt::WidgetAttribute <i>attribute</i>, bool <i>on</i> = true)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#autoFillBackground-prop">setAutoFillBackground</a></b>(bool <i>enabled</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setBackgroundRole">setBackgroundRole</a></b>(QPalette::ColorRole <i>role</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#baseSize-prop">setBaseSize</a></b>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setBaseSize-1">setBaseSize</a></b>(int <i>basew</i>, int <i>baseh</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setContentsMargins">setContentsMargins</a></b>(int <i>left</i>, int <i>top</i>, int <i>right</i>, int <i>bottom</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setContentsMargins-1">setContentsMargins</a></b>(const QMargins &amp;<i>margins</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#contextMenuPolicy-prop">setContextMenuPolicy</a></b>(Qt::ContextMenuPolicy <i>policy</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#cursor-prop">setCursor</a></b>(<i>const QCursor &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setEditFocus">setEditFocus</a></b>(bool <i>enable</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setFixedHeight">setFixedHeight</a></b>(int <i>h</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setFixedSize">setFixedSize</a></b>(const QSize &amp;<i>s</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setFixedSize-1">setFixedSize</a></b>(int <i>w</i>, int <i>h</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setFixedWidth">setFixedWidth</a></b>(int <i>w</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setFocus">setFocus</a></b>(Qt::FocusReason <i>reason</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a></b>(Qt::FocusPolicy <i>policy</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setFocusProxy">setFocusProxy</a></b>(QWidget *<i>w</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#font-prop">setFont</a></b>(<i>const QFont &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setForegroundRole">setForegroundRole</a></b>(QPalette::ColorRole <i>role</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#geometry-prop">setGeometry</a></b>(<i>const QRect &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setGeometry-1">setGeometry</a></b>(int <i>x</i>, int <i>y</i>, int <i>w</i>, int <i>h</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setGraphicsEffect">setGraphicsEffect</a></b>(QGraphicsEffect *<i>effect</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#inputMethodHints-prop">setInputMethodHints</a></b>(Qt::InputMethodHints <i>hints</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setLayout">setLayout</a></b>(QLayout *<i>layout</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#layoutDirection-prop">setLayoutDirection</a></b>(Qt::LayoutDirection <i>direction</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#locale-prop">setLocale</a></b>(const QLocale &amp;<i>locale</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setMask">setMask</a></b>(const QBitmap &amp;<i>bitmap</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setMask-1">setMask</a></b>(const QRegion &amp;<i>region</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#maximumHeight-prop">setMaximumHeight</a></b>(int <i>maxh</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#maximumSize-prop">setMaximumSize</a></b>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setMaximumSize-1">setMaximumSize</a></b>(int <i>maxw</i>, int <i>maxh</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#maximumWidth-prop">setMaximumWidth</a></b>(int <i>maxw</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#minimumHeight-prop">setMinimumHeight</a></b>(int <i>minh</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#minimumSize-prop">setMinimumSize</a></b>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setMinimumSize-1">setMinimumSize</a></b>(int <i>minw</i>, int <i>minh</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#minimumWidth-prop">setMinimumWidth</a></b>(int <i>minw</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mouseTracking-prop">setMouseTracking</a></b>(bool <i>enable</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#palette-prop">setPalette</a></b>(<i>const QPalette &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setParent">setParent</a></b>(QWidget *<i>parent</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setParent-1">setParent</a></b>(QWidget *<i>parent</i>, Qt::WindowFlags <i>f</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setShortcutAutoRepeat">setShortcutAutoRepeat</a></b>(int <i>id</i>, bool <i>enable</i> = true)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setShortcutEnabled">setShortcutEnabled</a></b>(int <i>id</i>, bool <i>enable</i> = true)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#sizeIncrement-prop">setSizeIncrement</a></b>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setSizeIncrement-1">setSizeIncrement</a></b>(int <i>w</i>, int <i>h</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#sizePolicy-prop">setSizePolicy</a></b>(<i>QSizePolicy</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setSizePolicy-1">setSizePolicy</a></b>(QSizePolicy::Policy <i>horizontal</i>, QSizePolicy::Policy <i>vertical</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#statusTip-prop">setStatusTip</a></b>(<i>const QString &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setStyle">setStyle</a></b>(QStyle *<i>style</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#tabletTracking-prop">setTabletTracking</a></b>(bool <i>enable</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#toolTip-prop">setToolTip</a></b>(<i>const QString &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#toolTipDuration-prop">setToolTipDuration</a></b>(int <i>msec</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#updatesEnabled-prop">setUpdatesEnabled</a></b>(bool <i>enable</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#whatsThis-prop">setWhatsThis</a></b>(<i>const QString &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowFilePath-prop">setWindowFilePath</a></b>(const QString &amp;<i>filePath</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setWindowFlag">setWindowFlag</a></b>(Qt::WindowType <i>flag</i>, bool <i>on</i> = true)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowFlags-prop">setWindowFlags</a></b>(Qt::WindowFlags <i>type</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowIcon-prop">setWindowIcon</a></b>(const QIcon &amp;<i>icon</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowModality-prop">setWindowModality</a></b>(Qt::WindowModality <i>windowModality</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowOpacity-prop">setWindowOpacity</a></b>(qreal <i>level</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setWindowRole">setWindowRole</a></b>(const QString &amp;<i>role</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setWindowState">setWindowState</a></b>(Qt::WindowStates <i>windowState</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setupUi">setupUi</a></b>(QWidget *<i>widget</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QSize </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#size-prop">size</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QSize </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#sizeHint-prop">sizeHint</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QSize </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QSizePolicy </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#sizePolicy-prop">sizePolicy</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#stackUnder">stackUnder</a></b>(QWidget *<i>w</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#statusTip-prop">statusTip</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStyle *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#style">style</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#styleSheet-prop">styleSheet</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#testAttribute">testAttribute</a></b>(Qt::WidgetAttribute <i>attribute</i>) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#toolTip-prop">toolTip</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#toolTipDuration-prop">toolTipDuration</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#underMouse">underMouse</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#ungrabGesture">ungrabGesture</a></b>(Qt::GestureType <i>gesture</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#cursor-prop">unsetCursor</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#layoutDirection-prop">unsetLayoutDirection</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#locale-prop">unsetLocale</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#update-1">update</a></b>(int <i>x</i>, int <i>y</i>, int <i>w</i>, int <i>h</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#update-2">update</a></b>(const QRect &amp;<i>rect</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#update-3">update</a></b>(const QRegion &amp;<i>rgn</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#updateGeometry">updateGeometry</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#updatesEnabled-prop">updatesEnabled</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRegion </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#visibleRegion">visibleRegion</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#whatsThis-prop">whatsThis</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#width-prop">width</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> WId </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#winId">winId</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#window">window</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowFilePath-prop">windowFilePath</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Qt::WindowFlags </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowFlags-prop">windowFlags</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWindow *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowHandle">windowHandle</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QIcon </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowIcon-prop">windowIcon</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Qt::WindowModality </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowModality-prop">windowModality</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowOpacity-prop">windowOpacity</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowRole">windowRole</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Qt::WindowStates </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowState">windowState</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowTitle-prop">windowTitle</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Qt::WindowType </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowType">windowType</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#x-prop">x</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#y-prop">y</a></b>() const</td></tr>
</table></div>
<a name="reimplemented-public-functions"></a>
<h2 id="reimplemented-public-functions"><span lang="zh-cn">重新实现的功用函数</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual QPaintEngine *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#paintEngine">paintEngine</a></b>() const override</td></tr>
</table></div>
<ul>
<li class="fn">31 <span lang="zh-cn">公用函数继承自</span> <a href="../qtcore/qobject.html#public-functions">QObject</a></li>
<li class="fn">14 <span lang="zh-cn">功用函数</span> <a href="../qtgui/qpaintdevice.html#public-functions">QPaintDevice</a></li>
</ul>
<a name="public-slots"></a>
<h2 id="public-slots"><span lang="zh-cn">功用槽</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#close">close</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#hide">hide</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#lower">lower</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#raise">raise</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#repaint">repaint</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setDisabled">setDisabled</a></b>(bool <i>disable</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#enabled-prop">setEnabled</a></b>(<i>bool</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setFocus-1">setFocus</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setHidden">setHidden</a></b>(bool <i>hidden</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#styleSheet-prop">setStyleSheet</a></b>(const QString &amp;<i>styleSheet</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#visible-prop">setVisible</a></b>(bool <i>visible</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowModified-prop">setWindowModified</a></b>(<i>bool</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowTitle-prop">setWindowTitle</a></b>(<i>const QString &amp;</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#show">show</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#showFullScreen">showFullScreen</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#showMaximized">showMaximized</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#showMinimized">showMinimized</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#showNormal">showNormal</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#update">update</a></b>()</td></tr>
</table></div>
<ul>
<li class="fn">1 <span lang="zh-cn">功用槽继承自</span> <a href="../qtcore/qobject.html#public-slots">QObject</a></li>
</ul>
<a name="signals"></a>
<h2 id="signals"><span lang="zh-cn">信号</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#customContextMenuRequested">customContextMenuRequested</a></b>(const QPoint &amp;<i>pos</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowIconChanged">windowIconChanged</a></b>(const QIcon &amp;<i>icon</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#windowTitleChanged">windowTitleChanged</a></b>(const QString &amp;<i>title</i>)</td></tr>
</table></div>
<ul>
<li class="fn">2 <span lang="zh-cn">信号继承自</span> <a href="../qtcore/qobject.html#signals">QObject</a></li>
</ul>
<a name="static-public-members"></a>
<h2 id="static-public-members"><span lang="zh-cn">静态功用成员</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#createWindowContainer">createWindowContainer</a></b>(QWindow *<i>window</i>, QWidget *<i>parent</i> = nullptr, Qt::WindowFlags <i>flags</i> = ...)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#find">find</a></b>(WId <i>id</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#keyboardGrabber">keyboardGrabber</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mouseGrabber">mouseGrabber</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#setTabOrder">setTabOrder</a></b>(QWidget *<i>first</i>, QWidget *<i>second</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QMetaObject </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#staticMetaObject-var">staticMetaObject</a></b></td></tr>
</table></div>
<ul>
<li class="fn">9 <span lang="zh-cn">静态公用成员</span> <a href="../qtcore/qobject.html#static-public-members">QObject</a></li>
</ul>
<a name="protected-functions"></a>
<h2 id="protected-functions"><span lang="zh-cn">保护函数</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#actionEvent">actionEvent</a></b>(QActionEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#changeEvent">changeEvent</a></b>(QEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#closeEvent">closeEvent</a></b>(QCloseEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#contextMenuEvent">contextMenuEvent</a></b>(QContextMenuEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#create">create</a></b>(WId <i>window</i> = 0, bool <i>initializeWindow</i> = true, bool <i>destroyOldWindow</i> = true)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#destroy">destroy</a></b>(bool <i>destroyWindow</i> = true, bool <i>destroySubWindows</i> = true)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#dragEnterEvent">dragEnterEvent</a></b>(QDragEnterEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#dragLeaveEvent">dragLeaveEvent</a></b>(QDragLeaveEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#dragMoveEvent">dragMoveEvent</a></b>(QDragMoveEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#dropEvent">dropEvent</a></b>(QDropEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#enterEvent">enterEvent</a></b>(QEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusInEvent">focusInEvent</a></b>(QFocusEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusNextChild">focusNextChild</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusNextPrevChild">focusNextPrevChild</a></b>(bool <i>next</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusOutEvent">focusOutEvent</a></b>(QFocusEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#focusPreviousChild">focusPreviousChild</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#hideEvent">hideEvent</a></b>(QHideEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#inputMethodEvent">inputMethodEvent</a></b>(QInputMethodEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#keyPressEvent">keyPressEvent</a></b>(QKeyEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a></b>(QKeyEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#leaveEvent">leaveEvent</a></b>(QEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a></b>(QMouseEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a></b>(QMouseEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mousePressEvent">mousePressEvent</a></b>(QMouseEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#mouseReleaseEvent">mouseReleaseEvent</a></b>(QMouseEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#moveEvent">moveEvent</a></b>(QMoveEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#nativeEvent">nativeEvent</a></b>(const QByteArray &amp;<i>eventType</i>, void *<i>message</i>, long *<i>result</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#paintEvent">paintEvent</a></b>(QPaintEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#resizeEvent">resizeEvent</a></b>(QResizeEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#showEvent">showEvent</a></b>(QShowEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#tabletEvent">tabletEvent</a></b>(QTabletEvent *<i>event</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#wheelEvent">wheelEvent</a></b>(QWheelEvent *<i>event</i>)</td></tr>
</table></div>
<a name="reimplemented-protected-functions"></a>
<h2 id="reimplemented-protected-functions"><span lang="zh-cn">重新实现的保护函数</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#event">event</a></b>(QEvent *<i>event</i>) override</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#initPainter">initPainter</a></b>(QPainter *<i>painter</i>) const override</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual int </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#metric">metric</a></b>(QPaintDevice::PaintDeviceMetric <i>m</i>) const override</td></tr>
</table></div>
<ul>
<li class="fn">9 个保护函数继承自<a href="../qtcore/qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 个保护函数继承自<a href="../qtgui/qpaintdevice.html#protected-functions">QPaintDevice</a></li>
</ul>
<a name="protected-slots"></a>
<h2 id="protected-slots"><span lang="zh-cn">公用槽</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#updateMicroFocus">updateMicroFocus</a></b>()</td></tr>
</table></div>
<a name="macros"></a>
<h2 id="macros"><span lang="zh-cn">宏</span></h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qwidget.html#QWIDGETSIZE_MAX">QWIDGETSIZE_MAX</a></b></td></tr>
</table></div>
<a name="details"></a>
<!-- $$$QWidget-description -->
<div class="descr">
<h2 id="details"><span lang="zh-cn">详细信息</span></h2>
<p>&nbsp;<a href="qwidget.html">QWidget</a>类是所有用户界面对象的基类。</p>
<p>
组件是用户界面的原子（最小组成）:它接收来自窗口系统的鼠标、键盘和其他事件，并在屏幕上绘制自己的样子。每个组件都是矩形的，它们按照z轴顺序排序。一个组件被它的父组件和它前面的组件剪裁。</p>
<p>没有嵌入到父组件中的组件称为窗口。通常，窗口有框架和标题栏，尽管也可以使用合适的<a href="../qtcore/qt.html#WindowType-enum">窗口标志</a>创建没有这种装饰的窗口)。在Qt中，<a href="qmainwindow.html">QMainWindow</a>和<a href="qdialog.html">QDialog</a>的各种子类是最常见的窗口类型。</p>
<p>每个组件的构造函数都接受一个或两个标准参数:</p>
<ol class="1" type="1"><li>&nbsp;<code>QWidget *parent = 0</code>是新组件的父组件。如果它是0(默认值)，则新组件将是一个窗口。如果不是，它将是父节点的子节点，并受父节点几何形状的约束(除非指定<a href="../qtcore/qt.html#WindowType-enum">Qt::Window</a>为窗口标志)。</li>
<li><code>Qt::WindowFlags f = 0</code> <span lang="zh-cn">&nbsp;</span>(在可用的地方)设置窗口标志;默认值适用于几乎所有的组件，但是要获得没有窗口系统框架的窗口，必须使用特殊的标志。</li>
</ol>
<p>&nbsp;<a href="qwidget.html">QWidget</a>有很多成员函数，但其中一些没有直接的功能;例如，<a href="qwidget.html">QWidget</a>有一个字体属性，但它本身从不使用。有许多子类提供了真正的功能，如<a href="qlabel.html">QLabel</a>、<a href="qpushbutton.html">QPushButton</a>、<a href="qpushbutton.html">QPushButton</a>和<a href="qpushbutton.html">QPushButton</a>。</p>
<a name="top-level-and-child-widgets"></a>
<h3 ><span lang="zh-cn">顶级组件和子组件</span></h3>
<p>没有父组件的组件总是一个独立的窗口(顶级组件)。对于这些组件，<a href="qwidget.html#windowTitle-prop">setWindowTitle</a>()和<a href="qwidget.html#windowIcon-prop">setWindowIcon</a>()分别设置标题栏和图标。</p>
<p>非窗口组件是子组件，显示在它们的父组件中。Qt中的大多数组件主要用作子组件。例如，可以将按钮显示为顶级窗口，但大多数人更喜欢将按钮放在其他组件中，如<a href="qdialog.html">QDialog</a>。</p>
<p class="centerAlign"><img src="images/parent-child-widgets.png" alt="A parent widget containing various child widgets." /></p><p>
	上图显示了<a href="qgroupbox.html">QGroupBox</a><span lang="zh-cn">组件</span>用于在<a href="qgridlayout.html">QGridLayout</a>提供的布局中保存各种子组件。<span lang="zh-cn">这里用外边框标示了</span><a href="qlabel.html">QLabel</a>子组件，以表明它们的完整大小。</p>
<p>如果您想使用<a href="qwidget.html">QWidget</a>来容纳子组件，那么通常需要向父<a href="qwidget.html">QWidget</a>添加一个布局。有关更多信息，请参见<a href="layout.html">布局管理</a>。</p>
<a name="composite-widgets"></a>
<h3 ><span lang="zh-cn">组合组件</span></h3>
<p>当一个组件被用作容器来对多个组件件进行分组时，它被称为组合组件。这可以通过构建一个具有所需可视属性的组件(例如<a href="qframe.html">QFrame</a>)并向其添加子组件来创建，通常由布局管理。上面的图表显示了使用Qt 
Designer创建的组合组件。</p>
<p>组合组件也可以通过子类化标准组件(如<a href="qwidget.html">QWidget</a>或<a href="qframe.html">QFrame</a>)，并在子类的构造函数中添加必要的布局和子组件来创建。<a href="examples-widgets.html">Qt提供的许多示例</a>都使用这种方法，在Qt<a href="qtwidgets-index.html#tutorials">教程</a>中也有介绍。</p>
<h3 >自定义组件和<span lang="zh-cn">绘制</span></h3>
<p>由于<a href="qwidget.html">QWidget</a>是<a href="../qtgui/qpaintdevice.html">QPaintDevice</a>的子类，子类可用于显示使用一系列绘画操作与<a href="../qtgui/qpainter.html">QPainter</a>类的实例组成的自定义内容。这种方法与图形视图框架(<a href="graphicsview.html"><span lang="zh-cn">框架</span></a>)使用的画布风格方法不同，在后者中，项目由应用程序添加到场景中，并由框架本身渲染。</p>
<p>每个组件在其<a href="qwidget.html#paintEvent">paintEvent</a>()函数中执行所有绘制操作。每当组件需要重绘时(无论是由于外部更改还是应用程序请求)，都会调用这个函数。</p>
<p><span lang="zh-cn">8</span><a href="qtwidgets-widgets-analogclock-example.html">模拟时钟示例</a>展示了一个简单的组件如何处理绘制事件。</p>
<h3 >大小提示和大小策略</h3>
<p>当实现一个新的组件时，重新实现<a href="qwidget.html#sizeHint-prop">sizeHint</a>()为组件提供一个合理的默认大小并使用<a href="qwidget.html#sizePolicy-prop">setSizePolicy</a>()设置正确的大小策略几乎总是很有用的。</p>
<p>默认情况下，不提供大小提示的组合组件将根据其子组件的空间需求来调整大小。</p>
<p>
大小策略允许您为布局管理系统提供良好的默认行为，以便其他组件可以轻松地包含和管理您的布局。默认大小策略表示大小提示表示组件的首选大小，这对于许多组件来说通常已经足够了。</p>
<p><b>注意:</b>顶级组件的大小限制在桌面高度和宽度的2/3。<br>如果这些边界不充分，您可以<span lang="zh-cn">使用<a href="qwidget.html#size-prop">resize</a>()</span>手动调整组件的大小。</p><a name="events"></a>
<h3 ><span lang="zh-cn">事件</span></h3>
<p>组件响应通常由用户操作引起的事件。<br>Qt通过调用带有包含每个事件信息的<a href="../qtcore/qevent.html">QEvent</a>子类实例的特定事件处理程序函数，将事件交付给组件。</p>
<p>如果组件只包含子组件，则可能不需要实现任何事件处理程序。如果您想要检测子组件中的鼠标点击，请在组件的<a href="qwidget.html#mousePressEvent">mousePressEvent</a>()中调用子组件的<a href="qwidget.html#underMouse">underMouse</a>()函数。</p>
<p><a href="qtwidgets-widgets-scribble-example.html">Scribble示例</a>实现了更广泛的事件集，以处理鼠标移动、按钮按下和窗口大小调整。</p>
<p>你需要为你自己的组件提供行为和内容，但这里有一个与<a href="qwidget.html">QWidget</a>相关的事件的简要概述，从最常见的开始:</p>
<ul>
<li>每当组件需要重新绘制时，就会调用<a href="qwidget.html#paintEvent">paintEvent</a>()。每个显示自定义内容的组件都必须实现它。使用<a href="../qtgui/qpainter.html">QPainter</a>进行绘制只能在<a href="qwidget.html#paintEvent">paintEvent</a>()或由<a href="qwidget.html#paintEvent">paintEvent</a>()调用的函数中进行。</li>
<li><a href="qwidget.html#resizeEvent">resizeEvent</a>()在组件被调整大小时调用。</li>
<li>当鼠标光标在组件内部时按下鼠标按钮，或者当组件使用<a href="qwidget.html#grabMouse">grabMouse</a>()抓取鼠标时，将调用<a href="qwidget.html#mousePressEvent">mousePressEvent</a>()。<br>
按下鼠标而不释放它实际上与调用<a href="qwidget.html#grabMouse">grabMouse</a>()相同。</li>
<li>当鼠标按钮被释放时调用<a href="qwidget.html#mouseReleaseEvent">mouseReleaseEvent</a>()。当组件接收到相应的鼠标按下事件时，它将接收到鼠标释放事件。这意味着，如果用户在组件内按下鼠标，然后在释放鼠标按钮之前将鼠标拖动到其他地方，组件就会收到释放事件。有一个例外:如果鼠标按下时弹出菜单出现，这个弹出会立即窃取鼠标事件。</li>
<li>当用户在组件中双击时调用<a href="qwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a>()。如果用户双击，组件将收到一个鼠标按下事件、一个鼠标释放事件、(一个鼠标单击事件)、第二个鼠标按下事件、这个事件，最后是第二个鼠标释放事件。(如果在此操作期间鼠标没有保持稳定，也可能会收到一些鼠标移动事件。)在第二次单击到达之前，不可能区分单击和双击。(这就是为什么大多数GUI书籍都建议将双击作为单击的扩展，而不是触发不同的操作。)</li>
</ul>
<p>接受键盘输入的组件需要重新实现一些事件处理程序:</p>
<ul>
<li>每当键被按下时，就会调用<a href="qwidget.html#keyPressEvent">keyPressEvent</a>()，当键被按下的时间长到足以自动重复时，也会再次调用。如果焦点转换机制不使用<b>Tab</b>和<b>Shift+Tab</b>键，它们只会传递给组件。要强制组件处理这些键，必须重新实现<a href="qwidget.html#event">QWidget::event</a>()。</li>
<li>当组件获得键盘焦点时，将调用<a href="qwidget.html#focusInEvent">focusInEvent</a>()(假设您已经调用了<a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>())。行为良好的组件以一种清晰而谨慎的方式表明它们拥有键盘焦点。</li>
<li>当组件失去键盘焦点时调用<a href="qwidget.html#focusOutEvent">focusOutEvent</a>()。</li>
</ul>
<p>您可能还需要重新实现一些不太常见的事件处理程序:</p>
<ul>
<li>&nbsp;当按住鼠标按钮而鼠标移动时，将调用<a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>()。这在拖放操作期间非常有用。如果调用<a href="qwidget.html#mouseTracking-prop">setMouseTracking</a>(true)，即使没有按下按钮，也会得到鼠标移动事件。(请参见<a href="graphicsview.html#drag-and-drop">拖放指南</a>。)</li>
<li><a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>()在键被释放和按下时被调用(如果键是自动重复的)。在这种情况下，组件将为每次重复接收一对键释放和键按事件。如果焦点转换机制不使用<b>Tab</b> 
和<b>Shift+Tab</b>键，它们只会传递给组件。要强制组件处理这些键，必须重新实现<a href="qwidget.html#event">QWidget::event</a>()。</li>
<li>用户在组件有焦点时转动鼠标滚轮时，就会调用<a href="qwidget.html#wheelEvent">wheelEvent</a>()。</li>
<li>当鼠标进入组件的屏幕空间时调用<a href="qwidget.html#enterEvent">enterEvent</a>()。(这排除了组件的任何子组件所拥有的屏幕空间。)</li>
<li>当鼠标离开组件的屏幕空间时调用<a href="qwidget.html#leaveEvent">leaveEvent</a>()。如果鼠标进入一个子组件，它将不会引起<a href="qwidget.html#leaveEvent">leaveEvent</a>()。</li>
<li>当组件相对于其父组件移动时，将调用<a href="qwidget.html#moveEvent">moveEvent</a>()。</li>
<li>当用户关闭组件时(或当调用<a href="qwidget.html#close">close</a>()时)调用<a href="qwidget.html#closeEvent">closeEvent</a>()。</li>
</ul>
<p>在<a href="../qtcore/qevent.html#Type-enum">QEvent::Type</a>的文档中还描述了一些相当模糊的事件。要处理这些事件，需要直接重新实现<a href="qwidget.html#event">eve<span lang="zh-cn">nt</span></a>()。</p>
<p>event()的默认实现处理<b>Tab</b> 和<b>Shift+Tab</b> 
(移动键盘焦点)，并将大多数其他事件传递给上面的一个更专门的处理程序。</p>
<p>事件和用于交付它们的机制将在<a href="../qtcore/eventsandfilters.html">事件系统</a>中介绍。</p>
<a name="groups-of-functions-and-properties"></a>
<h3 >函数和属性组</h3>
<div class="table"><table class="generic">
 <thead><tr class="qt-style"><th >上下文</th><th ><span lang="zh-cn">函数</span>和属性</th></tr></thead>
<tr valign="top" class="odd"><td >窗口函数</td><td ><a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#raise">raise</a>(), <a href="qwidget.html#lower">lower</a>(), <a href="qwidget.html#close">close</a>()<span lang="zh-cn">。</span></td></tr>
<tr valign="top" class="even"><td >顶层窗口</td><td ><a href="qwidget.html#windowModified-prop">windowModified</a>, <a href="qwidget.html#windowTitle-prop">windowTitle</a>, <a href="qwidget.html#windowIcon-prop">windowIcon</a>, <a href="qwidget.html#isActiveWindow-prop">isActiveWindow</a>, <a href="qwidget.html#activateWindow">activateWindow</a>(), <a href="qwidget.html#minimized-prop">minimized</a>, <a href="qwidget.html#showMinimized">showMinimized</a>(), <a href="qwidget.html#maximized-prop">maximized</a>, <a href="qwidget.html#showMaximized">showMaximized</a>(), <a href="qwidget.html#fullScreen-prop">fullScreen</a>, <a href="qwidget.html#showFullScreen">showFullScreen</a>(), <a href="qwidget.html#showNormal">showNormal</a>()<span lang="zh-cn">。</span></td></tr>
<tr valign="top" class="odd"><td >窗口内容</td><td ><a href="qwidget.html#update">update</a>(), <a href="qwidget.html#repaint">repaint</a>(), <a href="qwidget.html#scroll">scroll</a>()<span lang="zh-cn">。</span></td></tr>
<tr valign="top" class="even"><td >几何</td><td ><a href="qwidget.html#pos-prop">pos</a>, <a href="qwidget.html#x-prop">x</a>(), <a href="qwidget.html#y-prop">y</a>(), <a href="qwidget.html#rect-prop">rect</a>, <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#width-prop">width</a>(), <a href="qwidget.html#height-prop">height</a>(), <a href="qwidget.html#pos-prop">move</a>(), <a href="qwidget.html#size-prop">resize</a>(), <a href="qwidget.html#sizePolicy-prop">sizePolicy</a>, <a href="qwidget.html#sizeHint-prop">sizeHint</a>(), <a href="qwidget.html#minimumSizeHint-prop">minimumSizeHint</a>(), <a href="qwidget.html#updateGeometry">updateGeometry</a>(), <a href="qwidget.html#layout">layout</a>(), <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#childrenRect-prop">childrenRect</a>, <a href="qwidget.html#childrenRegion-prop">childrenRegion</a>, <a href="qwidget.html#adjustSize">adjustSize</a>(), <a href="qwidget.html#mapFromGlobal">mapFromGlobal</a>(), <a href="qwidget.html#mapToGlobal">mapToGlobal</a>(), <a href="qwidget.html#mapFromParent">mapFromParent</a>(), <a href="qwidget.html#mapToParent">mapToParent</a>(), <a href="qwidget.html#maximumSize-prop">maximumSize</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>, <a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a>, <a href="qwidget.html#baseSize-prop">baseSize</a>, <a href="qwidget.html#setFixedSize">setFixedSize</a>()</td></tr>
<tr valign="top" class="odd"><td >模式</td><td ><a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#isVisibleTo">isVisibleTo</a>(), <a href="qwidget.html#enabled-prop">enabled</a>, <a href="qwidget.html#isEnabledTo">isEnabledTo</a>(), <a href="qwidget.html#modal-prop">modal</a>, <a href="qwidget.html#isWindow">isWindow</a>(), <a href="qwidget.html#mouseTracking-prop">mouseTracking</a>, <a href="qwidget.html#updatesEnabled-prop">updatesEnabled</a>, <a href="qwidget.html#visibleRegion">visibleRegion</a>()<span lang="zh-cn">。</span></td></tr>
<tr valign="top" class="even"><td >外观和感觉</td><td ><a href="qwidget.html#style">style</a>(), <a href="qwidget.html#setStyle">setStyle</a>(), <a href="stylesheet.html">styleSheet</a>, <a href="qwidget.html#cursor-prop">cursor</a>, <a href="stylesheet-reference.html#font">font</a>, <a href="qwidget.html#palette-prop">palette</a>, <a href="qwidget.html#backgroundRole">backgroundRole</a>(), <a href="qwidget.html#setBackgroundRole">setBackgroundRole</a>(), <a href="qwidget.html#fontInfo">fontInfo</a>(), <a href="qwidget.html#fontMetrics">fontMetrics</a>()<span lang="zh-cn">。</span></td></tr>
<tr valign="top" class="odd"><td >键盘焦点功能</td><td ><a href="qwidget.html#focus-prop">focus</a>, <a href="qwidget.html#focusPolicy-prop">focusPolicy</a>, <a href="qwidget.html#setFocus-1">setFocus</a>(), <a href="qwidget.html#clearFocus">clearFocus</a>(), <a href="qwidget.html#setTabOrder">setTabOrder</a>(), <a href="qwidget.html#setFocusProxy">setFocusProxy</a>(), <a href="qwidget.html#focusNextChild">focusNextChild</a>(), <a href="qwidget.html#focusPreviousChild">focusPreviousChild</a>()<span lang="zh-cn">。</span></td></tr>
<tr valign="top" class="even"><td >鼠标和键盘抓取</td><td ><a href="qwidget.html#grabMouse">grabMouse</a>(), <a href="qwidget.html#releaseMouse">releaseMouse</a>(), <a href="qwidget.html#grabKeyboard">grabKeyboard</a>(), <a href="qwidget.html#releaseKeyboard">releaseKeyboard</a>(), <a href="qwidget.html#mouseGrabber">mouseGrabber</a>(), <a href="qwidget.html#keyboardGrabber">keyboardGrabber</a>()<span lang="zh-cn">。</span></td></tr>
<tr valign="top" class="odd"><td >事件处理程序</td><td ><a href="qwidget.html#event">event</a>(), <a href="qwidget.html#mousePressEvent">mousePressEvent</a>(), <a href="qwidget.html#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="qwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>(), <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#wheelEvent">wheelEvent</a>(), <a href="qwidget.html#enterEvent">enterEvent</a>(), <a href="qwidget.html#leaveEvent">leaveEvent</a>(), <a href="qwidget.html#paintEvent">paintEvent</a>(), <a href="qwidget.html#moveEvent">moveEvent</a>(), <a href="qwidget.html#resizeEvent">resizeEvent</a>(), <a href="qwidget.html#closeEvent">closeEvent</a>(), <a href="qwidget.html#dragEnterEvent">dragEnterEvent</a>(), <a href="qwidget.html#dragMoveEvent">dragMoveEvent</a>(), <a href="qwidget.html#dragLeaveEvent">dragLeaveEvent</a>(), <a href="qwidget.html#dropEvent">dropEvent</a>(), <a href="../qtcore/qobject.html#childEvent">childEvent</a>(), <a href="qwidget.html#showEvent">showEvent</a>(), <a href="qwidget.html#hideEvent">hideEvent</a>(), <a href="../qtcore/qobject.html#customEvent">customEvent</a>(). <a href="qwidget.html#changeEvent">changeEvent</a>(),</td></tr>
<tr valign="top" class="even"><td >系统功能</td><td ><a href="qwidget.html#parentWidget">parentWidget</a>(), <a href="qwidget.html#window">window</a>(), <a href="qwidget.html#setParent">setParent</a>(), <a href="qwidget.html#winId">winId</a>(), <a href="qwidget.html#find">find</a>(), <a href="qwidget.html#metric">metric</a>()<span lang="zh-cn">。</span></td></tr>
<tr valign="top" class="odd"><td >上下文菜单</td><td ><a href="qwidget.html#contextMenuPolicy-prop">contextMenuPolicy</a>, <a href="qwidget.html#contextMenuEvent">contextMenuEvent</a>(), <a href="qwidget.html#customContextMenuRequested">customContextMenuRequested</a>(), <a href="qwidget.html#actions">actions</a>()</td></tr>
<tr valign="top" class="even"><td >交互式帮助</td><td ><a href="qwidget.html#toolTip-prop">setToolTip</a>(), <a href="qwidget.html#whatsThis-prop">setWhatsThis</a>()</td></tr>
</table></div>
<a name="widget-style-sheets"></a>
<h3 >组件样式表</h3>
<p>除了每个平台的标准组件样式外，还可以根据<a href="stylesheet.html">样式表</a>中指定的规则设置组件的样式。该特性使您能够自定义特定组件的外观，以向用户提供有关其用途的可视化提示。例如，可以以特定的方式设置按钮样式，以表明它执行破坏性操作。</p>
<p>组件样式表的使用在<a href="stylesheet.html">Qt样式表</a>文档中有更详细的描述。</p>
<h3 >透明和双重缓冲</h3>
<p>自Qt 4.0以来，<a href="qwidget.html">QWidget</a>自动双缓冲它的绘制，所以不需要在<a href="qwidget.html#paintEvent">paintEvent</a>()中编写双缓冲代码来避免闪烁。</p>
<p>从Qt 4.1开始，<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_ContentsPropagated</a>组件属性已弃用。相反，只要没有设置<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_PaintOnScreen</a>，默认情况下父组件的内容就会传递给它们的每个子组件。自定义组件可以通过更新不规则区域(创建非矩形子组件)或使用alpha组件不完整的颜色绘制来利用这个特性。下图显示了如何对自定义组件的属性和属性进行微调以达到不同的效果。</p>
<p class="centerAlign"><img src="images/propagation-custom.png" alt="" /></p>
	<p>在上面的图中，构造了一个带有移除区域的半透明矩形子组件，并将其添加到父组件(显示像素地图的<a href="qlabel.html">QLabel</a>)。然后，设置不同的属性和组件属性来实现不同的效果:</p>
<ul>
<li>左侧组件没有附加属性或组件属性设置。这种默认状态适合大多数使用透明、形状不规则或不使用不透明笔刷覆盖整个区域的自定义组件。</li>
<li>中心组件设置了<a href="qwidget.html#autoFillBackground-prop">autoFillBackground</a>属性。此属性用于自定义组件，这些组件依赖于该组件提供默认背景，并且不使用不透明的笔刷在其整个区域上绘制。</li>
<li>右边的组件设置了<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_OpaquePaintEvent</a>组件属性。这表示组件将用不透明的颜色覆盖整个区域。组件的区域最初是未初始化的，在图中用一个红色的对角网格图案表示，它照亮了覆盖的区域。WA_OpaquePaintArea属性对于需要快速绘制自己的专用内容且不需要默认填充背景的组件很有用。</li>
</ul>
<p>快速更新与简单的背景颜色定制组件,比如实时绘制或图形组件,最好是定义一个合适的背景颜色(使用<a href="qwidget.html#setBackgroundRole">setBackgroundRole</a>()
<span lang="zh-cn">函数并使用</span><a href="../qtgui/qpalette.html#ColorRole-enum">QPalette::Window</a><span lang="zh-cn">参数</span>),设置<a href="qwidget.html#autoFillBackground-prop">autoFillBackground</a>属性,只有实现必要的绘图功能组件的<a href="qwidget.html#paintEvent">paintEvent</a>()。</p>
<p>为了快速更新自定义组件，这些组件经常用不透明的内容覆盖整个区域，例如视频流组件，最好设置组件的<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_OpaquePaintEvent</a>，避免任何与重新绘制组件背景相关的不必要开销。</p>
<p>如果一个组件同时具有<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_OpaquePaintEvent</a>组件属性和设置的<a href="qwidget.html#autoFillBackground-prop">autoFillBackground</a>属性，则<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_OpaquePaintEvent</a>属性优先。根据您的需求，您应该选择其中之一。</p>
<p>从Qt 4.1开始，父组件的内容也传递到标准Qt组件。如果父组件以非标准的方式装饰，这可能会导致一些意想不到的结果，如下图所示。</p>
<p class="centerAlign"><img src="images/propagation-standard.png" alt="" /></p><p>
	在不使用子类化的情况下，定制标准Qt组件的绘制行为的范围略小于定制组件的范围。通常，标准组件的理想外观可以通过设置其<a href="qwidget.html#autoFillBackground-prop">autoFillBackground</a>属性来实现。</p>
<a name="creating-translucent-windows"></a>
<h3 >创建半透明的窗口</h3>
<p>从Qt 4.5开始，就可以在支持合成的窗口系统上创建带有半透明区域的窗口。</p>
<p>要在顶级组件中启用该特性，请使用<a href="qwidget.html#setAttribute">setAttribute</a>()设置其<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_TranslucentBackground</a>属性，并确保在希望部分透明的区域中使用非不透明的颜色绘制背景。</p>
<p><span lang="zh-cn">注意平台：</span></p>
<ul>
<li>X11:该特性依赖于支持ARGB可视化和合成窗口管理器的X服务器。</li>
<li>窗口组件需要设置<a href="../qtcore/qt.html#WindowType-enum">Qt::FramelessWindowHint</a>窗口标志以使半透明工作。</li>
</ul>
<a name="native-widgets-vs-alien-widgets"></a>
<h3 >本地组件vs外来组件</h3>
<p>在Qt 4.4中引入的外来组件是窗口系统所不知道的组件。它们没有与之关联的本机窗口句柄。<br>此功能显著加快组件绘制、调整大小和消除闪烁。</p>
<p>如果您需要本机窗口的旧行为，您可以选择以下选项之一:</p>
<ol class="1" type="1"><li><span lang="zh-cn">在你的环境中使用</span> <code>QT_USE_NATIVE_WINDOWS=1</code> 
	<span lang="zh-cn">。</span></li>
<li>在应用程序中设置<a href="../qtcore/qt.html#ApplicationAttribute-enum">Qt::AA_NativeWindows</a>属性。所有组件都将是本机组件。</li>
<li>&nbsp;在组件上设置<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_NativeWindow</a>属性:组件本身和它的所有祖先都将变成原生的(除非设置了<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_DontCreateNativeAncestors</a>)。</li>
<li>调用<a href="qwidget.html#winId">QWidget::winId</a>来强制执行本地窗口(这意味着<span lang="zh-cn">与</span>3<span lang="zh-cn">一样</span>)。</li>
<li>设置<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_PaintOnScreen</a>属性来强制执行一个本机窗口(这意味着<span lang="zh-cn">与</span>3<span lang="zh-cn">一样</span>)。</li>
</ol>
</div>
<p><b>请参考 </b><a href="../qtcore/qevent.html">QEvent</a>, <a href="../qtgui/qpainter.html">QPainter</a>, <a href="qgridlayout.html">QGridLayout</a>,
<span lang="zh-cn">和 </span><a href="qboxlayout.html">QBoxLayout</a><span lang="zh-cn">。</span></p>
<!-- @@@QWidget -->
<div class="types">
<h2><span lang="zh-cn">成员类型文档</span></h2>
<!-- $$$RenderFlag$$$DrawWindowBackground$$$DrawChildren$$$IgnoreMask -->
<h3 class="flags" id="RenderFlag-enum"><a name="RenderFlag-enum"></a>enum QWidget::<span class="name">RenderFlag</span><br/>flags QWidget::<span class="name">RenderFlags</span></h3>
<p>这个枚举描述了当调用<a href="qwidget.html#render">QWidget::render</a>()时如何<span lang="zh-cn">渲染</span>组件。</p>
<div class="table"><table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">
	<span lang="zh-cn">约束</span></th><th class="tblval"><span lang="zh-cn">值</span></th><th class="tbldscr">
	<span lang="zh-cn">描述</span></th></tr>
<tr><td class="topAlign"><code>QWidget::DrawWindowBackground</code></td><td class="topAlign tblval"><code>0x1</code></td><td class="topAlign">
	如果启用这个选项，即使<a href="qwidget.html#autoFillBackground-prop">autoFillBackground</a>没有设置，组件的背景也会渲染到目标中。<br>
	默认情况下，该选项是启用的。</td></tr>
<tr><td class="topAlign"><code>QWidget::DrawChildren</code></td><td class="topAlign tblval"><code>0x2</code></td><td class="topAlign">
	如果启用此选项，组件的子组件将递归渲染到目标中。<br>默认情况下，该选项是启用的。</td></tr>
<tr><td class="topAlign"><code>QWidget::IgnoreMask</code></td><td class="topAlign tblval"><code>0x4</code></td><td class="topAlign">
	如果启用此选项，在渲染到目标时，组件的<a href="qwidget.html#mask">QWidget::mask</a>()将被忽略。默认情况下，该选项是禁用的。</td></tr>
</table></div>
<p>这个<span lang="zh-cn">宏</span>在Qt 4.3中被引入或修改。</p>
<p>RenderFlags类型是<a href="../qtcore/qflags.html">QFlags</a>&lt;RenderFlag&gt;的类型定义。它存储RenderFlag值的OR组合。</p>
<!-- @@@RenderFlag -->
</div>
<div class="prop">
<h2>属性的文档</h2>
<!-- $$$acceptDrops-prop$$$acceptDrops$$$setAcceptDropsbool -->
<h3 class="fn" id="acceptDrops-prop"><a name="acceptDrops-prop"></a><span class="name">acceptDrops</span> : <span class="type">bool</span></h3>
<p>此属性保存是否为该组件启用拖放事件</p>
<p>将此属性设置为true将向系统宣布此组件可能能够接受拖放事件。</p>
<p>如果组件是桌面(<a href="qwidget.html#windowType">windowType</a>() == <a href="../qtcore/qt.html#WindowType-enum">Qt::Desktop</a>)，这可能会失败，如果其他应用程序正在使用桌面;<br>
您可以调用acceptDrops()来测试是否发生这种情况。</p>
<p><b>警告:</b> 不要在拖放事件处理程序中修改此属性。</p>
<p>默认情况下，该属性为<code>false</code>。</p>
<p><b><span lang="zh-cn">访问函数</span>:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>acceptDrops</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setAcceptDrops</b></span>(bool <i>on</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="graphicsview.html#drag-and-drop"><span lang="zh-cn">拖拽</span></a><span lang="zh-cn">。</span></p>
<!-- @@@acceptDrops -->
<!-- $$$accessibleDescription-prop$$$accessibleDescription$$$setAccessibleDescriptionconstQString& -->
<h3 class="fn" id="accessibleDescription-prop"><a name="accessibleDescription-prop"></a><span class="name">accessibleDescription</span> : <span class="type"><a href="../qtcore/qstring.html">QString</a></span></h3>
<p>此属性保存辅助技术所看到的组件描述</p>
<p>组件的可访问描述应该传达组件的功能。虽然<a href="qwidget.html#accessibleName-prop">accessibleName</a>应该是一个简短的字符串(例如<b>Save</b>)，但是描述应该给出更多的上下文，例如<b>Saves the current document</b>。</p>
<p>这个属性必须<a href="../qtdoc/internationalization.html">localized</a><span lang="zh-cn">(本地化)</span>。</p>
<p>默认情况下，此属性包含一个空字符串，Qt返回使用工具提示来提供此信息。</p>
<p><b><span lang="zh-cn">访问函数</span>:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><span class="name"><b>accessibleDescription</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setAccessibleDescription</b></span>(const QString &amp;<i>description</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#accessibleName-prop">QWidget::accessibleName</a> 
<span lang="zh-cn">和</span> <a href="../qtgui/qaccessibleinterface.html#text">QAccessibleInterface::text</a>()<span lang="zh-cn">。</span></p>
<!-- @@@accessibleDescription -->
<!-- $$$accessibleName-prop$$$accessibleName$$$setAccessibleNameconstQString& -->
<h3 class="fn" id="accessibleName-prop"><a name="accessibleName-prop"></a><span class="name">accessibleName</span> : <span class="type"><a href="../qtcore/qstring.html">QString</a></span></h3>
<p>此属性包含辅助技术所看到的组件名称</p>
<p>这是屏幕阅读器等辅助技术宣布这个组件的主要名称。对于大多数组件，不需要设置此属性。例如，对于<a href="qpushbutton.html">QPushButton</a>，将使用按钮的文本。</p>
<p>当组件不提供任何文本时，设置此属性非常重要。例如，只包含图标的按钮需要设置此属性以使用屏幕阅读器。名称应该是简短的，并且与组件传递的视觉信息等效。</p>
<p>这个属性必须<a href="../qtdoc/internationalization.html">localized</a><span lang="zh-cn">（</span>本地化<span lang="zh-cn">）</span>。</p>
<p>默认情况下，此属性包含一个空字符串。</p>
<p><b><span lang="zh-cn">访问函数</span>:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><span class="name"><b>accessibleName</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setAccessibleName</b></span>(const QString &amp;<i>name</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#accessibleDescription-prop">QWidget::accessibleDescription</a> 
<span lang="zh-cn">和</span> <a href="../qtgui/qaccessibleinterface.html#text">QAccessibleInterface::text</a>()<span lang="zh-cn">。</span></p>
<!-- @@@accessibleName -->
<!-- $$$autoFillBackground-prop$$$autoFillBackground$$$setAutoFillBackgroundbool -->
<h3 class="fn" id="autoFillBackground-prop"><a name="autoFillBackground-prop"></a><span class="name">autoFillBackground</span> : <span class="type">bool</span></h3>
<p>此属性用于判断组件背景是否自动填充</p>
<p>如果启用，该属性将导致Qt在调用paint事件之前填充组件的背景。使用的颜色是由组件<a href="../qtgui/qpalette.html">palette</a><span lang="zh-cn">（</span>调色板<span lang="zh-cn">）</span>中的<a href="../qtgui/qpalette.html#ColorRole-enum">QPalette::Window</a>颜色角色定义的。</p>
<p>此外，Windows总是用<a href="../qtgui/qpalette.html#ColorRole-enum">QPalette::Window</a>填充，除非设置了WA_OpaquePaintEvent或WA_NoSystemBackground属性。</p>
<p>如果一个组件的父组件有一个静态的渐变背景，这个属性不能被关闭(即，设置为false)。</p>
<p><b>警告:</b> Use this property with caution in conjunction with . 在使用<a href="stylesheet.html">Qt样式表</a>时，请谨慎使用此属性。当组件的样式表具有有效的背景或边框图像时，此属性将自动禁用。</p>
<p>默认情况下，该属性为<code>false</code>。</p>
<p>这个属性在Qt 4.1中被引入。</p>
<p><b><span lang="zh-cn">访问函数</span>:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>autoFillBackground</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setAutoFillBackground</b></span>(bool <i>enabled</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_OpaquePaintEvent</a>, <a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_NoSystemBackground</a>,
<span lang="zh-cn">和</span>
<a href="qwidget.html#transparency-and-double-buffering">透明和双重缓冲</a><span lang="zh-cn">。</span></p>
<!-- @@@autoFillBackground -->
<!-- $$$baseSize-prop$$$baseSize$$$setBaseSizeconstQSize&$$$setBaseSizeintint -->
<h3 class="fn" id="baseSize-prop"><a name="baseSize-prop"></a><span class="name">baseSize</span> : <span class="type"><a href="../qtcore/qsize.html">QSize</a></span></h3>
<p>此属性保存组件的基本大小</p>
<p>如果组件定义了<a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a>()，则使用基本大小来计算适当的组件大小。</p>
<p>默认情况下，对于新创建的组件，该属性的宽度和高度为零。</p>
<p><b><span lang="zh-cn">访问函数</span>:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QSize </td><td class="memItemRight bottomAlign"><span class="name"><b>baseSize</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setBaseSize</b></span>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#setBaseSize-1">setBaseSize</a></b></span>(int <i>basew</i>, int <i>baseh</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#sizeIncrement-prop">setSizeIncrement</a>()<span lang="zh-cn">。</span></p>
<!-- @@@baseSize -->
<!-- $$$childrenRect-prop$$$childrenRect -->
<h3 class="fn" id="childrenRect-prop"><a name="childrenRect-prop"></a><span class="name">childrenRect</span> : const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span></h3>
<p>此属性保存组件的子组件的边界矩形</p>
<p>隐藏的孩子被排除在外。</p>
<p><font style="vertical-align: inherit;">况下，对于没有子项的组件，此属性包含位于原点的宽度和高度为零的矩形。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QRect </td><td class="memItemRight bottomAlign"><span class="name"><b>childrenRect</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#childrenRegion-prop">childrenRegion</a>()
<span lang="zh-cn">和</span><a href="qwidget.html#geometry-prop">geometry</a>()<span lang="zh-cn">。</span></p>
<!-- @@@childrenRect -->
<!-- $$$childrenRegion-prop$$$childrenRegion -->
<h3 class="fn" id="childrenRegion-prop"><a name="childrenRegion-prop"></a><span class="name">childrenRegion</span> : const <span class="type"><a href="../qtgui/qregion.html">QRegion</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的子组件占用的组合区域</font></p>
<p><font style="vertical-align: inherit;">隐藏的孩子被排除在外。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，对于没有子级的组件，此属性包含一个空区域。</font></p>
<p><b><font style="vertical-align: inherit;">访问<span lang="zh-cn">函数</span>：</font></b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QRegion </td><td class="memItemRight bottomAlign"><span class="name"><b>childrenRegion</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#childrenRect-prop">childrenRect</a>(), <a href="qwidget.html#geometry-prop">geometry</a>(),
<span lang="zh-cn">和</span> <a href="qwidget.html#mask">mask</a>()<span lang="zh-cn">。</span></p>
<!-- @@@childrenRegion -->
<!-- $$$contextMenuPolicy-prop$$$contextMenuPolicy$$$setContextMenuPolicyQt::ContextMenuPolicy -->
<h3 class="fn" id="contextMenuPolicy-prop"><a name="contextMenuPolicy-prop"></a><span class="name">contextMenuPolicy</span> : <span class="type"><a href="../qtcore/qt.html#ContextMenuPolicy-enum">Qt::ContextMenuPolicy</a></span></h3>
<p>how the widget shows a context menu</p>
<p><font style="vertical-align: inherit;">这个属性的默认值是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ContextMenuPolicy-enum"><font style="vertical-align: inherit;">Qt::DefaultContextMenu</font></a><font style="vertical-align: inherit;">，这意味着</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#contextMenuEvent"><font style="vertical-align: inherit;">contextMenuEvent</font></a><font style="vertical-align: inherit;"> () 处理程序被调用。其他值<span lang="zh-cn">还有</span></font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ContextMenuPolicy-enum"><font style="vertical-align: inherit;">Qt::NoContextMenu</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ContextMenuPolicy-enum"><font style="vertical-align: inherit;">Qt::PreventContextMenu</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ContextMenuPolicy-enum"><font style="vertical-align: inherit;">Qt::ActionsContextMenu</font></a><font style="vertical-align: inherit;">和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ContextMenuPolicy-enum"><font style="vertical-align: inherit;">Qt::CustomContextMenu</font></a><font style="vertical-align: inherit;">。使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ContextMenuPolicy-enum"><font style="vertical-align: inherit;">Qt::CustomContextMenu</font></a><font style="vertical-align: inherit;">，<span lang="zh-cn">将</span>发出信号</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#customContextMenuRequested"><font style="vertical-align: inherit;">customContextMenuRequested</font></a><font style="vertical-align: inherit;"> () 。</font></p>
<p><b><font style="vertical-align: inherit;">访问<span lang="zh-cn">函数</span>：</font></b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> Qt::ContextMenuPolicy </td><td class="memItemRight bottomAlign"><span class="name"><b>contextMenuPolicy</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setContextMenuPolicy</b></span>(Qt::ContextMenuPolicy <i>policy</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#contextMenuEvent">contextMenuEvent</a>(), <a href="qwidget.html#customContextMenuRequested">customContextMenuRequested</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#actions">actions</a>()<span lang="zh-cn">。</span></p>
<!-- @@@contextMenuPolicy -->
<!-- $$$cursor-prop$$$cursor$$$setCursorconstQCursor&$$$unsetCursor -->
<h3 class="fn" id="cursor-prop"><a name="cursor-prop"></a><span class="name">cursor</span> : <span class="type"><a href="../qtgui/qcursor.html">QCursor</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存此组件的光标形状</font></p>
<p><font style="vertical-align: inherit;">当鼠标光标位于此组件上方时，它将渲染此形状。有关一系列有用的形状，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#CursorShape-enum"><font style="vertical-align: inherit;">预定义的光标对象列表</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">编辑器组件可能会使用 I 型光标：</font></p>
<pre class="cpp">

  setCursor(<span class="type">Qt</span><span class="operator">::</span>IBeamCursor);

</pre>
<p><font style="vertical-align: inherit;">如果没有设置<span lang="zh-cn">光标</span>，或者在调用 
unsetCursor() 之后，则使用父<span lang="zh-cn">光标</span>。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，该属性包含一个具有</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#CursorShape-enum"><font style="vertical-align: inherit;">Qt::ArrowCursor</font></a><font style="vertical-align: inherit;">形状的光标。</font></p>
<p>一些底层的窗口实现会在光标离开组件时重置光标，即使鼠标已经被捕获。如果您想为所有组件设置游标，即使是在窗口之外，请考虑<a href="../qtgui/qguiapplication.html#setOverrideCursor">QApplication::setOverrideCursor</a>()。</p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QCursor </td><td class="memItemRight bottomAlign"><span class="name"><b>cursor</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setCursor</b></span>(<i>const QCursor &amp;</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>unsetCursor</b></span>()</td></tr>
</table></div>
<p><b>请参考 </b><a href="../qtgui/qguiapplication.html#setOverrideCursor">QApplication::setOverrideCursor</a>()<span lang="zh-cn">。</span></p>
<!-- @@@cursor -->
<!-- $$$enabled-prop$$$isEnabled$$$setEnabledbool -->
<h3 class="fn" id="enabled-prop"><a name="enabled-prop"></a><span class="name">enabled</span> : <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存是否启用组件</font></p>
<p><font style="vertical-align: inherit;">通常，启用的组件处理键盘和鼠标事件；禁用的组件不会。</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qabstractbutton.html"><font style="vertical-align: inherit;">QAbstractButton</font></a><font style="vertical-align: inherit;">例外。</font></p>
<p><font style="vertical-align: inherit;">某些组件在禁用时会以不同方式显示。例如，按钮可能会将其标签绘制为灰色。如果您的组件需要知道<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum">何时启</a>用或禁用，您可以使用<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum">QEvent::EnabledChange</a>类型的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#changeEvent"><font style="vertical-align: inherit;">changeEvent</font></a><font style="vertical-align: inherit;"> () 。</font></p>
<p><font style="vertical-align: inherit;">禁用组件会隐式禁用其所有子组件。启用分别启用所有子组件，除非它们已被明确禁用。<span lang="zh-cn">当一个组件的</span>父组件仍处于禁用状态<span lang="zh-cn">时，</span>无法显式启用不是窗口的子组件。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性为</font><code>true</code><font style="vertical-align: inherit;">。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isEnabled</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setEnabled</b></span>(<i>bool</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#isEnabledTo">isEnabledTo</a>(), <a href="../qtgui/qkeyevent.html">QKeyEvent</a>, <a href="../qtgui/qmouseevent.html">QMouseEvent</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#changeEvent">changeEvent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@enabled -->
<!-- $$$focus-prop$$$hasFocus -->
<h3 class="fn" id="focus-prop"><a name="focus-prop"></a><span class="name">focus</span> : const <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存此组件（或其焦点代理）是否具有键盘输入焦点</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性为</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">获取一个<span lang="zh-cn">组件</span>的这个属性的值相当于检查</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qapplication.html#focusWidget"><font style="vertical-align: inherit;">QApplication::focusWidget</font></a><font style="vertical-align: inherit;"> ()是否引用了这个<span lang="zh-cn">组件</span>。</font></p><p><b><font style="vertical-align: inherit;">
	访问<span lang="zh-cn">函数</span>：</font></b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>hasFocus</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#setFocus-1">setFocus</a>(), <a href="qwidget.html#clearFocus">clearFocus</a>(), <a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>(),
<span lang="zh-cn">和 </span><a href="qapplication.html#focusWidget">QApplication::focusWidget</a>()<span lang="zh-cn">。</span></p>
<!-- @@@focus -->
<!-- $$$focusPolicy-prop$$$focusPolicy$$$setFocusPolicyQt::FocusPolicy -->
<h3 class="fn" id="focusPolicy-prop"><a name="focusPolicy-prop"></a><span class="name">focusPolicy</span> : <span class="type"><a href="../qtcore/qt.html#FocusPolicy-enum">Qt::FocusPolicy</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件接受键盘焦点的方式</font></p>
<p><font style="vertical-align: inherit;"><span lang="zh-cn">如果</span>策略是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#FocusPolicy-enum"><font style="vertical-align: inherit;">Qt::TabFocus</font></a><span lang="zh-cn">，</span><font style="vertical-align: inherit;"><span lang="zh-cn">则</span>组件通过 Tab 键接受键盘焦点，</font><span lang="zh-cn">如果策略是</span><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#FocusPolicy-enum"><font style="vertical-align: inherit;">Qt::ClickFocus</font></a><span lang="zh-cn">，则</span><font style="vertical-align: inherit;">组件通过点击接受焦点，<span lang="zh-cn">如果策略是</span></font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#FocusPolicy-enum"><font style="vertical-align: inherit;">Qt::StrongFocus</font></a><span lang="zh-cn">，</span><font style="vertical-align: inherit;"><span lang="zh-cn">则</span>同时接受<span lang="zh-cn">点击和Tab</span>，<span lang="zh-cn">如果策略是</span></font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#FocusPolicy-enum"><font style="vertical-align: inherit;">Qt::NoFocus</font></a><font style="vertical-align: inherit;">（默认）<span lang="zh-cn">，则</span>它不接受<span lang="zh-cn">任何</span>焦点。</font></p>
<p><font style="vertical-align: inherit;">如果组件处理键盘事件，则必须为组件启用键盘焦点。这通常是通过组件的构造函数完成的。例如，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlineedit.html"><font style="vertical-align: inherit;">QLineEdit</font></a><font style="vertical-align: inherit;">构造函数调用 setFocusPolicy( </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#FocusPolicy-enum"><font style="vertical-align: inherit;">Qt::StrongFocus</font></a><font style="vertical-align: inherit;"> )。</font></p>
<p><font style="vertical-align: inherit;">如果组件具有焦点代理，则焦点策略将传递到它。</font></p>
<p><b><font style="vertical-align: inherit;">访问<span lang="zh-cn">函数</span>：</font></b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> Qt::FocusPolicy </td><td class="memItemRight bottomAlign"><span class="name"><b>focusPolicy</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setFocusPolicy</b></span>(Qt::FocusPolicy <i>policy</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>(),
<span lang="zh-cn">和</span><a href="qwidget.html#enabled-prop">enabled</a><span lang="zh-cn">。</span></p>
<!-- @@@focusPolicy -->
<!-- $$$font-prop$$$font$$$setFontconstQFont& -->
<h3 class="fn" id="font-prop"><a name="font-prop"></a><span class="name">font</span> : <span class="type"><a href="../qtgui/qfont.html">QFont</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存当前为组件设置的字体</font></p>
<p><font style="vertical-align: inherit;">描述组件请求的字体。该字体在渲染标准组件时由组件的样式使用，并且可用作确保自定义组件可以与本机平台的外观和感觉保持一致的一种方式。不同的平台或不同的样式为应用程序定义不同的字体是很常见的。</font></p>
<p><font style="vertical-align: inherit;">当您为组件分配新字体时，该字体的属性将与组件的默认字体组合以形成组件的最终字体。您可以调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#fontInfo"><font style="vertical-align: inherit;">fontInfo</font></a><font style="vertical-align: inherit;"> () 来获取组件最终字体的副本。最后的字体也用于初始化</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpainter.html"><font style="vertical-align: inherit;">QPainter</font></a><font style="vertical-align: inherit;">的字体。</font></p>
<p>默认值取决于系统环境。<br>QApplication维护一个系统/主题字体，它作为所有组件的默认字体。<br>
对于某些类型的组件，可能还有特殊的默认字体。<br>您还可以通过将自定义字体和组件名称传递给QApplication::setFont()来为组件定义默认字体。<br>
最后，将字体与Qt的字体数据库进行匹配，以找到最佳匹配。</p>
<p><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">将显式字体属性从父级传递到子级。如果您更改字体的特定属性并将该字体分配给组件，该属性将传递到组件的所有子项，覆盖该属性的任何系统默认值。请注意，除非启用了<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum">Qt::WA_WindowPropagation</a>属性，否则默认情况下字体不会传递到窗口（请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isWindow"><font style="vertical-align: inherit;">isWindow</font></a><font style="vertical-align: inherit;"> ()）。</font></p>
<p><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">的字体传递类似于它的调色板传递。</font></p>
<p>
当前样式用于渲染所有标准Qt组件的内容，可以自由选择使用组件字体，或者在某些情况下，忽略它(部分或全部)。特别是，某些样式(如GTK样式、Mac样式和Windows 
Vista样式)会对组件字体进行特殊修改，以匹配平台的本机外观和感觉。因此，将属性赋给组件的字体并不一定会改变组件的外观。相反，您可以选择应用<a href="stylesheet.html">样式表</a>.</p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">如果<span lang="zh-cn">同时使用</span>setFont() 
<span lang="zh-cn">和</span></font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/stylesheet.html"><font style="vertical-align: inherit;">Qt 样式表，</font></a><font style="vertical-align: inherit;"><span lang="zh-cn">并且</span>设置冲突，<span lang="zh-cn">则有限使用</span>样式表。</font></p><p><b><font style="vertical-align: inherit;">
	访问<span lang="zh-cn">函数</span>：</font></b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> const QFont &amp;</td><td class="memItemRight bottomAlign"><span class="name"><b>font</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setFont</b></span>(<i>const QFont &amp;</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#fontInfo">fontInfo</a>() <span lang="zh-cn">
和</span> <a href="qwidget.html#fontMetrics">fontMetrics</a>()<span lang="zh-cn">。</span></p>
<!-- @@@font -->
<!-- $$$frameGeometry-prop$$$frameGeometry -->
<h3 class="fn" id="frameGeometry-prop"><a name="frameGeometry-prop"></a><span class="name">frameGeometry</span> : const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span></h3>
<p><font style="vertical-align: inherit;">组件相对于其父级的几何形状，包括任何窗口框架</font></p>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个取决于用户平台和屏幕几何形状的值。</font></p>
<p><b><font style="vertical-align: inherit;">访问<span lang="zh-cn">函数</span>：</font></b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QRect </td><td class="memItemRight bottomAlign"><span class="name"><b>frameGeometry</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#geometry-prop">geometry</a>(), <a href="qwidget.html#x-prop">x</a>(), <a href="qwidget.html#y-prop">y</a>(),
<span lang="zh-cn">和</span> <a href="qwidget.html#pos-prop">pos</a>()<span lang="zh-cn">。</span></p>
<!-- @@@frameGeometry -->
<!-- $$$frameSize-prop$$$frameSize -->
<h3 class="fn" id="frameSize-prop"><a name="frameSize-prop"></a><span class="name">frameSize</span> : const <span class="type"><a href="../qtcore/qsize.html">QSize</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的大小，包括任何窗口框架</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个取决于用户平台和屏幕几何形状的值。</font></p>
<p><b><font style="vertical-align: inherit;">访问<span lang="zh-cn">函数</span>：</font></b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QSize </td><td class="memItemRight bottomAlign"><span class="name"><b>frameSize</b></span>() const</td></tr>
</table></div>
<!-- @@@frameSize -->
<!-- $$$fullScreen-prop$$$isFullScreen -->
<h3 class="fn" id="fullScreen-prop"><a name="fullScreen-prop"></a><span class="name">fullScreen</span> : const <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件是否以全屏模式显示</font></p>
<p><font style="vertical-align: inherit;">全屏模式下的组件占据整个屏幕区域，并且不显示窗口装饰，例如标题栏。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性为</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">访问<span lang="zh-cn">函数</span>：</font></b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isFullScreen</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#windowState">windowState</a>(), <a href="qwidget.html#minimized-prop">minimized</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#maximized-prop">maximized</a><span lang="zh-cn">。</span></p>
<!-- @@@fullScreen -->
<!-- $$$geometry-prop$$$geometry$$$setGeometryintintintint$$$setGeometryconstQRect& -->
<h3 class="fn" id="geometry-prop"><a name="geometry-prop"></a><span class="name">geometry</span> : <span class="type"><a href="../qtcore/qrect.html">QRect</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件相对于其父级的几何形状，不包括窗口框架</font></p>
<p><font style="vertical-align: inherit;">更改几何图形时，组件（如果可见）会立即接收移动事件（</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#moveEvent"><font style="vertical-align: inherit;">moveEvent</font></a><font style="vertical-align: inherit;"> ()）和/或调整大小事件（</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#resizeEvent"><font style="vertical-align: inherit;">resizeEvent</font></a><font style="vertical-align: inherit;"> ()）。如果组件当前不可见，则保证在显示之前接收适当的事件。</font></p>
<p><font style="vertical-align: inherit;">如果大组件位于由</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">minimumSize</font></a><font style="vertical-align: inherit;"> () 和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#maximumSize-prop"><font style="vertical-align: inherit;">maximumSize</font></a><font style="vertical-align: inherit;"> ()定义的范围之外，则会对其进行调整。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#resizeEvent"><font style="vertical-align: inherit;">resizeEvent</font></a><font style="vertical-align: inherit;"> () 或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#moveEvent"><font style="vertical-align: inherit;">moveEvent</font></a><font style="vertical-align: inherit;"> () 中调用 setGeometry( ) 会导致无限递归。</font></p>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个取决于用户平台和屏幕几何形状的值。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> const QRect &amp;</td><td class="memItemRight bottomAlign"><span class="name"><b>geometry</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#setGeometry-1">setGeometry</a></b></span>(int <i>x</i>, int <i>y</i>, int <i>w</i>, int <i>h</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setGeometry</b></span>(<i>const QRect &amp;</i>)</td></tr>
</table></div>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#frameGeometry-prop"><font style="vertical-align: inherit;">frameGeometry</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#rect-prop"><font style="vertical-align: inherit;">rect</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#pos-prop"><font style="vertical-align: inherit;">move</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#size-prop"><font style="vertical-align: inherit;">resize</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#moveEvent"><font style="vertical-align: inherit;">moveEvent</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#resizeEvent"><font style="vertical-align: inherit;">resizeEvent</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">minimumSize</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#maximumSize-prop"><font style="vertical-align: inherit;">maximumSize</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@geometry -->
<!-- $$$height-prop$$$height -->
<h3 class="fn" id="height-prop"><a name="height-prop"></a><span class="name">height</span> : const <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的高度，不包括任何窗口框架</font></p>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">请勿使用此功能在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qdesktopwidget.html"><font style="vertical-align: inherit;">多屏桌面</font></a><font style="vertical-align: inherit;">上查找屏幕高度。有关详细信息，请阅读</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qdesktopwidget.html#screen-geometry"><font style="vertical-align: inherit;">此注<span lang="zh-cn">解</span>释</font></a><font style="vertical-align: inherit;">。</font></p><p><font style="vertical-align: inherit;">默认情况下，此属性包含一个取决于用户平台和屏幕几何形状的值。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>height</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#width-prop">width</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#size-prop">size</a><span lang="zh-cn">。</span></p>
<!-- @@@height -->
<!-- $$$inputMethodHints-prop$$$inputMethodHints$$$setInputMethodHintsQt::InputMethodHints -->
<h3 class="fn" id="inputMethodHints-prop"><a name="inputMethodHints-prop"></a><span class="name">inputMethodHints</span> : <span class="type"><a href="../qtcore/qt.html#InputMethodHint-enum">Qt::InputMethodHints</a></span></h3>
<p><font style="vertical-align: inherit;">组件具有什么<span lang="zh-cn">特定1</span>输入法提示。</font></p>
<p><font style="vertical-align: inherit;">这仅与输入组件相关。输入法使用它来检索有关输入法应如何操作的提示。例如，如果设置了</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#InputMethodHint-enum"><font style="vertical-align: inherit;">Qt::ImhFormattedNumbersOnly</font></a><font style="vertical-align: inherit;">标志，则输入法可能会更改其视觉组件以反映只能输入数字。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">某些组件需要某些标志才能按预期工作。要设置标志，请执行</font><code>w-&gt;setInputMethodHints(w-&gt;inputMethodHints()|f)</code><font style="vertical-align: inherit;">而不是</font><code>w-&gt;setInputMethodHints(f)</code><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">标志只是提示，因此特定的输入法实现可以随意忽略它们。如果要确保输入某种<span lang="zh-cn">格式</span>的字符，还应该在组件上设置</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qvalidator.html"><font style="vertical-align: inherit;">QValidator</font></a><font style="vertical-align: inherit;">。</font></p><p><font style="vertical-align: inherit;">默认值为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#InputMethodHint-enum"><font style="vertical-align: inherit;">Qt::ImhNone</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">这个属性是在 Qt 4.6 中引入的。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> Qt::InputMethodHints </td><td class="memItemRight bottomAlign"><span class="name"><b>inputMethodHints</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setInputMethodHints</b></span>(Qt::InputMethodHints <i>hints</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#inputMethodQuery">inputMethodQuery</a>()<span lang="zh-cn">。</span></p>
<!-- @@@inputMethodHints -->
<!-- $$$isActiveWindow-prop$$$isActiveWindow -->
<h3 class="fn" id="isActiveWindow-prop"><a name="isActiveWindow-prop"></a><span class="name">isActiveWindow</span> : const <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存此组件的窗口是否为活动窗口</font></p>
<p><font style="vertical-align: inherit;">活动窗口是包含具有键盘焦点的组件的窗口（如果窗口没有组件或没有任何组件接受键盘焦点，则该窗口可能仍具有焦点）。</font></p>
<p><font style="vertical-align: inherit;">当弹出窗口可见时，此属性</font><code>true</code><font style="vertical-align: inherit;">适用于活动窗口</font><i><font style="vertical-align: inherit;">和</font></i><font style="vertical-align: inherit;">弹出窗口。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性为</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isActiveWindow</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#activateWindow">activateWindow</a>()
<span lang="zh-cn">和 </span><a href="qapplication.html#activeWindow">QApplication::activeWindow</a>()<span lang="zh-cn">。</span></p>
<!-- @@@isActiveWindow -->
<!-- $$$layoutDirection-prop$$$layoutDirection$$$setLayoutDirectionQt::LayoutDirection$$$unsetLayoutDirection -->
<h3 class="fn" id="layoutDirection-prop"><a name="layoutDirection-prop"></a><span class="name">layoutDirection</span> : <span class="type"><a href="../qtcore/qt.html#LayoutDirection-enum">Qt::LayoutDirection</a></span></h3>
<p>此属性保存此组件的布局方向</p>
<p><font style="vertical-align: inherit;">默认情况下，此属性<span lang="zh-cn">被</span>设置为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#LayoutDirection-enum"><font style="vertical-align: inherit;">Qt::LeftToRight</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">当在组件上设置布局方向时，它将传播到组件的子级，但不会传播到作为窗口的子级，也不会传播到已显式调用 setLayoutDirection() 的子级。此外，在为父级调用 setLayoutDirection()</font><i><font style="vertical-align: inherit;">之后</font></i><font style="vertical-align: inherit;">添加的子组件不会继承父级的布局方向。</font></p>
<p><font style="vertical-align: inherit;">自 Qt 4.7 起，此方法不再影响文本布局方向。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> Qt::LayoutDirection </td><td class="memItemRight bottomAlign"><span class="name"><b>layoutDirection</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setLayoutDirection</b></span>(Qt::LayoutDirection <i>direction</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>unsetLayoutDirection</b></span>()</td></tr>
</table></div>
<p><b>请参考 </b><a href="../qtgui/qguiapplication.html#layoutDirection-prop">QApplication::layoutDirection</a><span lang="zh-cn">。</span></p>
<!-- @@@layoutDirection -->
<!-- $$$locale-prop$$$locale$$$setLocaleconstQLocale&$$$unsetLocale -->
<h3 class="fn" id="locale-prop"><a name="locale-prop"></a><span class="name">locale</span> : <span class="type"><a href="../qtcore/qlocale.html">QLocale</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的语言环境</font></p>
<p><font style="vertical-align: inherit;">只要没有设置特殊语言环境，<span lang="zh-cn">可能继承</span>父语言环境或（如果此组件是顶级组件）<span lang="zh-cn">使用</span>默认语言环境。</font></p>
<p><font style="vertical-align: inherit;">如果组件显示日期或数字，则应使用组件的区域设置对其进行格式化。</font></p>
<p><font style="vertical-align: inherit;">这个属性是在 Qt 4.3 中引入的。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QLocale </td><td class="memItemRight bottomAlign"><span class="name"><b>locale</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setLocale</b></span>(const QLocale &amp;<i>locale</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>unsetLocale</b></span>()</td></tr>
</table></div>
<p><b>请参考 </b><a href="../qtcore/qlocale.html">QLocale</a> and <a href="../qtcore/qlocale.html#setDefault">QLocale::setDefault</a>()<span lang="zh-cn">。</span></p>
<!-- @@@locale -->
<!-- $$$maximized-prop$$$isMaximized -->
<h3 class="fn" id="maximized-prop"><a name="maximized-prop"></a><span class="name">maximized</span> : const <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">属性保存此组件是否最大化</font></p>
<p><font style="vertical-align: inherit;">此属性仅与窗口相关。</font></p>
<p><b><font style="vertical-align: inherit;">：</font></b><font style="vertical-align: inherit;">由于某些窗口系统的限制，这并不<span lang="zh-cn">会得到</span>预期的结果（例如，如果 X11 上的用户通过窗口管理器最大化窗口，Qt 无法将其与任何其他调整大小区分开来）。随着窗口管理器协议的发展，这有望得到改善。</font></p><p><font style="vertical-align: inherit;">默认情况下，此属性为</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isMaximized</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#windowState">windowState</a>(), <a href="qwidget.html#showMaximized">showMaximized</a>(), <a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#showNormal">showNormal</a>(),
<span lang="zh-cn">和</span> <a href="qwidget.html#minimized-prop">minimized</a><span lang="zh-cn">。</span></p>
<!-- @@@maximized -->
<!-- $$$maximumHeight-prop$$$maximumHeight$$$setMaximumHeightint -->
<h3 class="fn" id="maximumHeight-prop"><a name="maximumHeight-prop"></a><span class="name">maximumHeight</span> : <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的最大高度（以像素为单位）</font></p>
<p><font style="vertical-align: inherit;">此属性对应于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#maximumSize-prop"><font style="vertical-align: inherit;">maximumSize</font></a><font style="vertical-align: inherit;">属性所保持的高度。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含值 16777215。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><code>QWIDGETSIZE_MAX</code><font style="vertical-align: inherit;">宏的定义限制了组件的最大尺寸。</font></p><p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>maximumHeight</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMaximumHeight</b></span>(int <i>maxh</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#maximumSize-prop">maximumSize</a> 
<span lang="zh-cn">和 </span><a href="qwidget.html#maximumWidth-prop">maximumWidth</a><span lang="zh-cn">。</span></p>
<!-- @@@maximumHeight -->
<!-- $$$maximumSize-prop$$$maximumSize$$$setMaximumSizeconstQSize&$$$setMaximumSizeintint -->
<h3 class="fn" id="maximumSize-prop"><a name="maximumSize-prop"></a><span class="name">maximumSize</span> : <span class="type"><a href="../qtcore/qsize.html">QSize</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的最大尺寸（以像素为单位）</font></p>
<p><font style="vertical-align: inherit;">组件的大小不能调整为比最大组件尺寸更大的尺寸。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个大小，其中宽度和高度的值为 16777215。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><code>QWIDGETSIZE_MAX</code><font style="vertical-align: inherit;">宏的定义限制了组件的最大尺寸。</font></p><p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QSize </td><td class="memItemRight bottomAlign"><span class="name"><b>maximumSize</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMaximumSize</b></span>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#setMaximumSize-1">setMaximumSize</a></b></span>(int <i>maxw</i>, int <i>maxh</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#maximumWidth-prop">maximumWidth</a>, <a href="qwidget.html#maximumHeight-prop">maximumHeight</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a><span lang="zh-cn">。</span></p>
<!-- @@@maximumSize -->
<!-- $$$maximumWidth-prop$$$maximumWidth$$$setMaximumWidthint -->
<h3 class="fn" id="maximumWidth-prop"><a name="maximumWidth-prop"></a><span class="name">maximumWidth</span> : <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的最大宽度（以像素为单位）</font></p>
<p><font style="vertical-align: inherit;">此属性对应于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#maximumSize-prop"><font style="vertical-align: inherit;">maximumSize</font></a><font style="vertical-align: inherit;">属性所保持的宽度。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含值 16777215。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><code>QWIDGETSIZE_MAX</code><font style="vertical-align: inherit;">宏的定义限制了组件的最大尺寸。</font></p><p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>maximumWidth</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMaximumWidth</b></span>(int <i>maxw</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#maximumSize-prop">maximumSize</a> 
<span lang="zh-cn">和 </span><a href="qwidget.html#maximumHeight-prop">maximumHeight</a><span lang="zh-cn">。</span></p>
<!-- @@@maximumWidth -->
<!-- $$$minimized-prop$$$isMinimized -->
<h3 class="fn" id="minimized-prop"><a name="minimized-prop"></a><span class="name">minimized</span> : const <span class="type">bool</span></h3>
<p>此属性表示该组件是否最小化(图标化)。</p>
<p><font style="vertical-align: inherit;">此属性仅与窗口相关。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性为</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isMinimized</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#showMinimized">showMinimized</a>(), <a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#showNormal">showNormal</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#maximized-prop">maximized</a><span lang="zh-cn">。</span></p>
<!-- @@@minimized -->
<!-- $$$minimumHeight-prop$$$minimumHeight$$$setMinimumHeightint -->
<h3 class="fn" id="minimumHeight-prop"><a name="minimumHeight-prop"></a><span class="name">minimumHeight</span> : <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的最小高度（以像素为单位）</font></p>
<p>T<font style="vertical-align: inherit;">此属性对应于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">minimumSize</font></a><font style="vertical-align: inherit;">属性所保持的高度。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性的值为 0。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>minimumHeight</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMinimumHeight</b></span>(int <i>minh</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#minimumSize-prop">minimumSize</a> 
<span lang="zh-cn">和 </span><a href="qwidget.html#minimumWidth-prop">minimumWidth</a><span lang="zh-cn">。</span></p>
<!-- @@@minimumHeight -->
<!-- $$$minimumSize-prop$$$minimumSize$$$setMinimumSizeconstQSize&$$$setMinimumSizeintint -->
<h3 class="fn" id="minimumSize-prop"><a name="minimumSize-prop"></a><span class="name">minimumSize</span> : <span class="type"><a href="../qtcore/qsize.html">QSize</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的最小尺寸</font></p>
<p><font style="vertical-align: inherit;">组件的大小不能调整为比最组件尺寸更小的尺寸。如果当前尺寸较小，则组件的尺寸将被强制为最小尺寸。</font></p>
<p><font style="vertical-align: inherit;">此函数设置的最小尺寸将覆盖</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlayout.html"><font style="vertical-align: inherit;">QLayout</font></a><font style="vertical-align: inherit;">定义的最小尺寸。要取消设置最小尺寸，请使用 值</font><code>QSize(0, 0)</code><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含宽度和高度为零的大小。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QSize </td><td class="memItemRight bottomAlign"><span class="name"><b>minimumSize</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMinimumSize</b></span>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#setMinimumSize-1">setMinimumSize</a></b></span>(int <i>minw</i>, int <i>minh</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#minimumWidth-prop">minimumWidth</a>, <a href="qwidget.html#minimumHeight-prop">minimumHeight</a>, <a href="qwidget.html#maximumSize-prop">maximumSize</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a><span lang="zh-cn">。</span></p>
<!-- @@@minimumSize -->
<!-- $$$minimumSizeHint-prop$$$minimumSizeHint -->
<h3 class="fn" id="minimumSizeHint-prop"><a name="minimumSizeHint-prop"></a><span class="name">minimumSizeHint</span> : const <span class="type"><a href="../qtcore/qsize.html">QSize</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的推荐最小尺寸</font></p>
<p>I<font style="vertical-align: inherit;">如果此属性的值是无效大小，则<span lang="zh-cn">不包含推荐的</span>最小大小。</font></p>
<p><font style="vertical-align: inherit;">如果此组件没有布局，则 minimumSizeHint() 的默认实现将返回无效大小，否则返回布局的最小大小。大多数内置组件重新实现了 minimumSizeHint()。</font></p>
<p><font style="vertical-align: inherit;">除非设置了</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">minimumSize</font></a><font style="vertical-align: inherit;"> () 或将大小策略设置为 QSizePolicy::Ignore，否则<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlayout.html">QLayout</a>永远不会将组件的大小调整为小于最小大小提示的大小。如果设置了</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">minimumSize</font></a><font style="vertical-align: inherit;"> ()，最小尺寸提示将被忽略。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> virtual QSize </td><td class="memItemRight bottomAlign"><span class="name"><b>minimumSizeHint</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="../qtcore/qsize.html#isValid">QSize::isValid</a>(), <a href="qwidget.html#size-prop">resize</a>(), <a href="qwidget.html#minimumSize-prop">setMinimumSize</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#sizePolicy-prop">sizePolicy</a>()<span lang="zh-cn">。</span></p>
<!-- @@@minimumSizeHint -->
<!-- $$$minimumWidth-prop$$$minimumWidth$$$setMinimumWidthint -->
<h3 class="fn" id="minimumWidth-prop"><a name="minimumWidth-prop"></a><span class="name">minimumWidth</span> : <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的最小宽度（以像素为单位）</font></p>
<p><font style="vertical-align: inherit;">此属性对应于</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">minimumSize</font></a><font style="vertical-align: inherit;">属性所保持的宽度。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性的值为 0。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>minimumWidth</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMinimumWidth</b></span>(int <i>minw</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#minimumSize-prop">minimumSize</a> 
<span lang="zh-cn">和 </span><a href="qwidget.html#minimumHeight-prop">minimumHeight</a><span lang="zh-cn">。</span></p>
<!-- @@@minimumWidth -->
<!-- $$$modal-prop$$$isModal -->
<h3 class="fn" id="modal-prop"><a name="modal-prop"></a><span class="name">modal</span> : const <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件是否为模态组件</font></p>
<p><font style="vertical-align: inherit;">这个属性只对windows有意义。模态组件可防止所有其他窗口中的组件获得任何输入。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性为</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isModal</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#isWindow">isWindow</a>(), <a href="qwidget.html#windowModality-prop">windowModality</a>,
<span lang="zh-cn">和 </span><a href="qdialog.html">QDialog</a><span lang="zh-cn">。</span></p>
<!-- @@@modal -->
<!-- $$$mouseTracking-prop$$$hasMouseTracking$$$setMouseTrackingbool -->
<h3 class="fn" id="mouseTracking-prop"><a name="mouseTracking-prop"></a><span class="name">mouseTracking</span> : <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存是否为组件启用鼠标跟踪</font></p>
<p><font style="vertical-align: inherit;">如果禁用鼠标跟踪（默认设置），则组件仅在移动鼠标时至少按下一个鼠标按钮时才会接收鼠标移动事件。</font></p>
<p><font style="vertical-align: inherit;">如果启用鼠标跟踪，即使没有按下任何按钮，组件也会收到鼠标移动事件。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>hasMouseTracking</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setMouseTracking</b></span>(bool <i>enable</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@mouseTracking -->
<!-- $$$normalGeometry-prop$$$normalGeometry -->
<h3 class="fn" id="normalGeometry-prop"><a name="normalGeometry-prop"></a><span class="name">normalGeometry</span> : const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的几何形状，<span lang="zh-cn">当</span>它在<span lang="zh-cn">作为顶级组件时显示正常大小时(</span>非最大化或全屏）<span lang="zh-cn">为该值。</span></font></p>
<p><font style="vertical-align: inherit;">对于子组件，此属性始终包含一个空矩形。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个空矩形。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QRect </td><td class="memItemRight bottomAlign"><span class="name"><b>normalGeometry</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#windowState">QWidget::windowState</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#geometry-prop">QWidget::geometry</a><span lang="zh-cn">。</span></p>
<!-- @@@normalGeometry -->
<!-- $$$palette-prop$$$palette$$$setPaletteconstQPalette& -->
<h3 class="fn" id="palette-prop"><a name="palette-prop"></a><span class="name">palette</span> : <span class="type"><a href="../qtgui/qpalette.html">QPalette</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的调色板</font></p>
<p><font style="vertical-align: inherit;">此属性描述组件的调色板。调色板在渲染标准组件时由组件的样式使用，可用作确保自定义组件可以与本机平台的外观和感觉保持一致的一种方式。不同的平台或不同的风格有不同的调色板是很常见的。</font></p>
<p><font style="vertical-align: inherit;">当您将新调色板分配给组件时，此调色板中的颜色角色将与组件的默认调色板组合以形成组件的最终调色板。组件背景角色的调色板条目用于填充组件的背景（参见</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#autoFillBackground-prop"><font style="vertical-align: inherit;">QWidget::autoFillBackground</font></a><font style="vertical-align: inherit;">），前景角色初始化</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtgui/qpainter.html"><font style="vertical-align: inherit;">QPainter</font></a><font style="vertical-align: inherit;">的画笔。</font></p>
<p><font style="vertical-align: inherit;">默认值取决于系统环境。</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qapplication.html"><font style="vertical-align: inherit;">QApplication</font></a><font style="vertical-align: inherit;">维护一个系统/主题调色板，作为所有组件的默认设置。某些类型的组件也可能有特殊的调色板默认值（例如，在 Windows Vista 上，所有从</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qmenubar.html"><font style="vertical-align: inherit;">QMenuBar</font></a><font style="vertical-align: inherit;">派生的类都有一个特殊的默认调色板）。您还可以通过将自定义调色板和组件的名称传递给</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qapplication.html#setPalette"><font style="vertical-align: inherit;">QApplication::setPalette</font></a><font style="vertical-align: inherit;"> ()来自己定义组件的默认调色板。最后，样式始终可以选择在指定时抛光调色板（请参阅</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qstyle.html#polish"><font style="vertical-align: inherit;">QStyle::polish</font></a><font style="vertical-align: inherit;"> ()）。</font></p>
<p><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">将显式调色板角色从父级传播到子级。如果您将画笔或颜色分配给调色板上的特定角色并将该调色板分配给组件，则该角色将传播到组件的所有子项，覆盖该角色的任何系统默认值。请注意，除非启用了<a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum">Qt::WA_WindowPropagation</a>属性，否则默认情况下调色板不会传播到窗口（请参阅</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isWindow"><font style="vertical-align: inherit;">isWindow</font></a><font style="vertical-align: inherit;"> ()）。</font></p>
<p><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">的调色板传播类似于其字体传播。</font></p>
<p><font style="vertical-align: inherit;">当前样式用于渲染所有标准 Qt 组件的内容，可以从组件调色板中自由选择颜色和画笔，或者在某些情况下，忽略调色板（部分或完全）。特别是某些样式，如 
GTK 样式、Mac 样式和 Windows Vista 样式，依赖第三方 API 来渲染组件的内容，并且这些样式通常不遵循调色板。因此，不能保证为组件的调色板分配角色会改变组件的外观。相反，您可以选择应用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/stylesheet.html"><font style="vertical-align: inherit;">styleSheet</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>警告</b>不要将此函数与<a href="stylesheet.html">Qt样式表</a>一起使用。当使用样式表时，可以使用&quot;color&quot;， 
&quot;background-color&quot;， &quot;selection-color&quot;， 
&quot;selection-background-color&quot;和&quot;alternate-background-color&quot;来定制组件的调色板。</p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> const QPalette &amp;</td><td class="memItemRight bottomAlign"><span class="name"><b>palette</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setPalette</b></span>(<i>const QPalette &amp;</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qapplication.html#palette">QApplication::palette</a>(), <a href="qwidget.html#font-prop">QWidget::font</a>(),
<span lang="zh-cn">和 </span><a href="stylesheet.html">Qt Style Sheets</a><span lang="zh-cn">。</span></p>
<!-- @@@palette -->
<!-- $$$pos-prop$$$pos$$$moveintint$$$moveconstQPoint& -->
<h3 class="fn" id="pos-prop"><a name="pos-prop"></a><span class="name">pos</span> : <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件在其父组件中的位置</font></p>
<p><font style="vertical-align: inherit;">如果组件是窗口，则位置是组件在桌面上的位置，包括其框架。</font></p>
<p><font style="vertical-align: inherit;">更改位置时，组件（如果可见）会立即接收移动事件（</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#moveEvent"><font style="vertical-align: inherit;">moveEvent</font></a><font style="vertical-align: inherit;"> ()）。如果组件当前不可见，则保证在显示之前收到一个事件。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含引用原点的位置。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;"><span lang="zh-cn">在</span></font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#moveEvent"><font style="vertical-align: inherit;">moveEvent</font></a><font style="vertical-align: inherit;">（）<span lang="zh-cn">内调用move（）或<a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#geometry-prop">setGeometry</a>（）</span>会导致无限递归。</font></p>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QPoint </td><td class="memItemRight bottomAlign"><span class="name"><b>pos</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#move-1">move</a></b></span>(int <i>x</i>, int <i>y</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>move</b></span>(<i>const QPoint &amp;</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#x-prop">x</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#y-prop">y</a>()<span lang="zh-cn">。</span></p>
<!-- @@@pos -->
<!-- $$$rect-prop$$$rect -->
<h3 class="fn" id="rect-prop"><a name="rect-prop"></a><span class="name">rect</span> : const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span></h3>
<p><font style="vertical-align: inherit;">属性包含组件的内部几何形状，不包括任何窗口框架</font></p>
<p><font style="vertical-align: inherit;">rect 属性等于</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qrect.html"><font style="vertical-align: inherit;">QRect</font></a><font style="vertical-align: inherit;"> (0, 0, </font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#width-prop"><font style="vertical-align: inherit;">width</font></a><font style="vertical-align: inherit;"> (), </font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#height-prop"><font style="vertical-align: inherit;">height</font></a><font style="vertical-align: inherit;"> ())。</font></p>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个取决于用户平台和屏幕几何形状的值。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QRect </td><td class="memItemRight bottomAlign"><span class="name"><b>rect</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#size-prop">size</a><span lang="zh-cn">。</span></p>
<!-- @@@rect -->
<!-- $$$size-prop$$$size$$$resizeintint$$$resizeconstQSize& -->
<h3 class="fn" id="size-prop"><a name="size-prop"></a><span class="name">size</span> : <span class="type"><a href="../qtcore/qsize.html">QSize</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的大小，不包括任何窗口框架</font></p>
<p><font style="vertical-align: inherit;">如果组件在调整大小时可见，它会立即收到一个调整大小事件（</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#resizeEvent"><font style="vertical-align: inherit;">resizeEvent</font></a><font style="vertical-align: inherit;"> ()）。如果组件当前不可见，则保证在显示之前收到一个事件。</font></p>
<p><font style="vertical-align: inherit;">如果大小超出由</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">minimumSize</font></a><font style="vertical-align: inherit;"> () 和</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#maximumSize-prop"><font style="vertical-align: inherit;">maximumSize</font></a><font style="vertical-align: inherit;"> ()定义的范围，则调整大小。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个取决于用户平台和屏幕几何形状的值。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">在</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#geometry-prop"><font style="vertical-align: inherit;">resizeEvent</font></a><font style="vertical-align: inherit;"> () 内部调用 resize() 或</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#resizeEvent"><font style="vertical-align: inherit;">setGeometry</font></a><font style="vertical-align: inherit;"> () 会导致无限递归。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">将大小设置为</font><code>QSize(0, 0)</code><font style="vertical-align: inherit;">将导致组件不会出现在屏幕上。这也适用于窗户。</font></p><p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QSize </td><td class="memItemRight bottomAlign"><span class="name"><b>size</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#resize-1">resize</a></b></span>(int <i>w</i>, int <i>h</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>resize</b></span>(<i>const QSize &amp;</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#pos-prop">pos</a>, <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>, <a href="qwidget.html#maximumSize-prop">maximumSize</a>, <a href="qwidget.html#resizeEvent">resizeEvent</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#adjustSize">adjustSize</a>()<span lang="zh-cn">。</span></p>
<!-- @@@size -->
<!-- $$$sizeHint-prop$$$sizeHint -->
<h3 class="fn" id="sizeHint-prop"><a name="sizeHint-prop"></a><span class="name">sizeHint</span> : const <span class="type"><a href="../qtcore/qsize.html">QSize</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的推荐大小</font></p>
<p><font style="vertical-align: inherit;">如果此属性的值是无效大小，则<span lang="zh-cn">没有推荐的</span>大小</font></p>
<p><font style="vertical-align: inherit;">如果此组件没有布局，则 sizeHint() 的默认实现将返回无效大小，否则返回布局的首选大小。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> virtual QSize </td><td class="memItemRight bottomAlign"><span class="name"><b>sizeHint</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="../qtcore/qsize.html#isValid">QSize::isValid</a>(), <a href="qwidget.html#minimumSizeHint-prop">minimumSizeHint</a>(), <a href="qwidget.html#sizePolicy-prop">sizePolicy</a>(), <a href="qwidget.html#minimumSize-prop">setMinimumSize</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#updateGeometry">updateGeometry</a>()<span lang="zh-cn">。</span></p>
<!-- @@@sizeHint -->
<!-- $$$sizeIncrement-prop$$$sizeIncrement$$$setSizeIncrementconstQSize&$$$setSizeIncrementintint -->
<h3 class="fn" id="sizeIncrement-prop"><a name="sizeIncrement-prop"></a><span class="name">sizeIncrement</span> : <span class="type"><a href="../qtcore/qsize.html">QSize</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的大小增量</font></p>
<p><font style="vertical-align: inherit;">用户调整窗口大小时，大小将按 sizeIncrement() 的步骤移动。</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#width-prop"><font style="vertical-align: inherit;">width</font></a><font style="vertical-align: inherit;"> () 像素水平和 sizeIncrement。</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#height-prop"><font style="vertical-align: inherit;">height</font></a><font style="vertical-align: inherit;"> () 垂直像素，以</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#baseSize-prop"><font style="vertical-align: inherit;">baseSize</font></a><font style="vertical-align: inherit;"> () 为基础。首选组件大小适用于非负整数</font><i><font style="vertical-align: inherit;">i</font></i><font style="vertical-align: inherit;">和</font><i><font style="vertical-align: inherit;">j</font></i><font style="vertical-align: inherit;">：</font></p>
<pre class="cpp">

  width <span class="operator">=</span> baseSize()<span class="operator">.</span>width() <span class="operator">+</span> i <span class="operator">*</span> sizeIncrement()<span class="operator">.</span>width();
  height <span class="operator">=</span> baseSize()<span class="operator">.</span>height() <span class="operator">+</span> j <span class="operator">*</span> sizeIncrement()<span class="operator">.</span>height();

</pre>
<p>N<font style="vertical-align: inherit;">请注意，虽然您可以为所有组件设置大小增量，但它仅<span lang="zh-cn">对窗口有效</span>。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含宽度和高度为零的大小。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">大小增量在 Windows 下无效，在 X11 上可能会被窗口管理器忽略。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QSize </td><td class="memItemRight bottomAlign"><span class="name"><b>sizeIncrement</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setSizeIncrement</b></span>(<i>const QSize &amp;</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#setSizeIncrement-1">setSizeIncrement</a></b></span>(int <i>w</i>, int <i>h</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#maximumSize-prop">maximumSize</a><span lang="zh-cn">。</span></p>
<!-- @@@sizeIncrement -->
<!-- $$$sizePolicy-prop$$$sizePolicy$$$setSizePolicyQSizePolicy$$$setSizePolicyQSizePolicy::PolicyQSizePolicy::Policy -->
<h3 class="fn" id="sizePolicy-prop"><a name="sizePolicy-prop"></a><span class="name">sizePolicy</span> : <span class="type"><a href="qsizepolicy.html">QSizePolicy</a></span></h3>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含宽度和高度为零的大小。</font></p>
<p><font style="vertical-align: inherit;">如果有一个</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlayout.html"><font style="vertical-align: inherit;">QLayout</font></a><font style="vertical-align: inherit;">管理这个组件的子组件，则使用该布局指定的大小策略。如果没有这样的</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlayout.html"><font style="vertical-align: inherit;">QLayout</font></a><font style="vertical-align: inherit;">，则使用此函数的结果。</font></p>
<p><font style="vertical-align: inherit;">默认策略是Preferred/Preferred，这意味着widget可以自由调整大小，但更倾向于</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeHint-prop"><font style="vertical-align: inherit;">sizeHint</font></a><font style="vertical-align: inherit;"> ()返回的大小。类似按钮的组件设置大小策略以指定它们可以水平拉伸，但垂直固定。这同样适用于 lineedit 
组件（例如</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlineedit.html"><font style="vertical-align: inherit;">QLineEdit</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qspinbox.html"><font style="vertical-align: inherit;">QSpinBox</font></a><font style="vertical-align: inherit;">或可编辑的</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qcombobox.html"><font style="vertical-align: inherit;">QComboBox</font></a><font style="vertical-align: inherit;">）和其他水平方向的组件（例如</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qprogressbar.html"><font style="vertical-align: inherit;">QProgressBar</font></a><font style="vertical-align: inherit;">）。</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qtoolbutton.html"><font style="vertical-align: inherit;">QToolButton</font></a><font style="vertical-align: inherit;">通常是方形的，因此它们允许在两个方向上增长。支持不同方向的组件（如</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qslider.html"><font style="vertical-align: inherit;">QSlider</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qscrollbar.html"><font style="vertical-align: inherit;">QScrollBar</font></a><font style="vertical-align: inherit;">或 QHeader) 仅指定在相应方向上的拉伸。可以提供滚动条的组件（通常是</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qscrollarea.html"><font style="vertical-align: inherit;">QScrollArea 的</font></a><font style="vertical-align: inherit;">子类）倾向于指定它们可以使用额外的空间，并且它们可以使用小于</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeHint-prop"><font style="vertical-align: inherit;">sizeHint</font></a><font style="vertical-align: inherit;"> () 的空间来凑合。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QSizePolicy </td><td class="memItemRight bottomAlign"><span class="name"><b>sizePolicy</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setSizePolicy</b></span>(<i>QSizePolicy</i>)</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#setSizePolicy-1">setSizePolicy</a></b></span>(QSizePolicy::Policy <i>horizontal</i>, QSizePolicy::Policy <i>vertical</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#sizeHint-prop">sizeHint</a>(), <a href="qlayout.html">QLayout</a>, <a href="qsizepolicy.html">QSizePolicy</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#updateGeometry">updateGeometry</a>()<span lang="zh-cn">。</span></p>
<!-- @@@sizePolicy -->
<!-- $$$statusTip-prop$$$statusTip$$$setStatusTipconstQString& -->
<h3 class="fn" id="statusTip-prop"><a name="statusTip-prop"></a><span class="name">statusTip</span> : <span class="type"><a href="../qtcore/qstring.html">QString</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的状态提示</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个空字符串。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><span class="name"><b>statusTip</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setStatusTip</b></span>(<i>const QString &amp;</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#toolTip-prop">toolTip</a> <span lang="zh-cn">
和 </span><a href="qwidget.html#whatsThis-prop">whatsThis</a><span lang="zh-cn">。</span></p>
<!-- @@@statusTip -->
<!-- $$$styleSheet-prop$$$styleSheet$$$setStyleSheetconstQString& -->
<h3 class="fn" id="styleSheet-prop"><a name="styleSheet-prop"></a><span class="name">styleSheet</span> : <span class="type"><a href="../qtcore/qstring.html">QString</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的样式表</font></p>
<p><font style="vertical-align: inherit;">样式表包含组件样式自定义的文本描述，如</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/stylesheet.html"><font style="vertical-align: inherit;">Qt 样式表</font></a><font style="vertical-align: inherit;">文档中所述。</font></p>
<p><font style="vertical-align: inherit;">从 Qt 4.5 开始，Qt 样式表完全支持</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtdoc/internationalization.html#macos"><font style="vertical-align: inherit;">macOS</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">自定义</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qstyle.html"><font style="vertical-align: inherit;">QStyle</font></a><font style="vertical-align: inherit;">子类当前不支持 Qt 样式表。我们计划在未来的某个版本中解决这个问题。</font></p>
<p><font style="vertical-align: inherit;">这个属性是在 Qt 4.2 中引入的。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><span class="name"><b>styleSheet</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setStyleSheet</b></span>(const QString &amp;<i>styleSheet</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#setStyle">setStyle</a>(), <a href="qapplication.html#styleSheet-prop">QApplication::styleSheet</a>,
<span lang="zh-cn">和 </span><a href="stylesheet.html">Q<span lang="zh-cn">t样式表</span></a><span lang="zh-cn">。</span></p>
<!-- @@@styleSheet -->
<!-- $$$tabletTracking-prop$$$hasTabletTracking$$$setTabletTrackingbool -->
<h3 class="fn" id="tabletTracking-prop"><a name="tabletTracking-prop"></a><span class="name">tabletTracking</span> : <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存是否为组件启用平板电脑跟踪</font></p>
<p><font style="vertical-align: inherit;">
果平板电脑跟踪被禁用（默认），则组件仅在触控笔与平板电脑接触时或在移动触控笔时至少按下一个触控笔按钮时才会接收平板电脑移动事件。</font></p>
<p><font style="vertical-align: inherit;">如果启用平板电脑跟踪，即使在附近悬停时，组件也会收到平板电脑移动事件。这对于监视位置以及辅助属性（例如旋转和倾斜）以及在 UI 中提供反馈很有用。</font></p>
<p><font style="vertical-align: inherit;">这个属性是在 Qt 5.9 中引入的。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>hasTabletTracking</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setTabletTracking</b></span>(bool <i>enable</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#tabletEvent">tabletEvent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@tabletTracking -->
<!-- $$$toolTip-prop$$$toolTip$$$setToolTipconstQString& -->
<h3 class="fn" id="toolTip-prop"><a name="toolTip-prop"></a><span class="name">toolTip</span> : <span class="type"><a href="../qtcore/qstring.html">QString</a></span></h3>
<p><font style="vertical-align: inherit;">此属性包含组件的工具提示</font></p>
<p><font style="vertical-align: inherit;">请注意，默认情况下，工具提示仅针对作为活动窗口子项的组件显示。您可以通过在<i>window</i>上设置属性</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum"><font style="vertical-align: inherit;">Qt::WA_AlwaysShowToolTips</font></a><font style="vertical-align: inherit;">来更改此行为，而不是在带有工具提示的组件上。</font></p>
<p><font style="vertical-align: inherit;">如果你想控制工具提示的行为，你可以拦截</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#event"><font style="vertical-align: inherit;">event</font></a><font style="vertical-align: inherit;"> () 函数并捕获</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::ToolTip</font></a><font style="vertical-align: inherit;">事件（例如，如果你想自定义应该显示工具提示的区域）。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个空字符串。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><span class="name"><b>toolTip</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setToolTip</b></span>(<i>const QString &amp;</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qtooltip.html">QToolTip</a>, <a href="qwidget.html#statusTip-prop">statusTip</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#whatsThis-prop">whatsThis</a><span lang="zh-cn">。</span></p>
<!-- @@@toolTip -->
<!-- $$$toolTipDuration-prop$$$toolTipDuration$$$setToolTipDurationint -->
<h3 class="fn" id="toolTipDuration-prop"><a name="toolTipDuration-prop"></a><span class="name">toolTipDuration</span> : <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的工具提示持续时间</font></p>
<p><font style="vertical-align: inherit;">指定工具提示将显示多长时间，以毫秒为单位。如果值为 -1（默认），则根据工具提示的长度计算持续时间。</font></p>
<p><font style="vertical-align: inherit;">这个属性是在 Qt 5.2 中引入的。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>toolTipDuration</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setToolTipDuration</b></span>(int <i>msec</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#toolTip-prop">toolTip</a><span lang="zh-cn">。</span></p>
<!-- @@@toolTipDuration -->
<!-- $$$updatesEnabled-prop$$$updatesEnabled$$$setUpdatesEnabledbool -->
<h3 class="fn" id="updatesEnabled-prop"><a name="updatesEnabled-prop"></a><span class="name">updatesEnabled</span> : <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存是否启用更新</font></p>
<p><font style="vertical-align: inherit;">启用更新的组件接收绘制事件并具有系统背景；禁用的组件不会。这也意味着如果禁用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update"><font style="vertical-align: inherit;">更新</font></a><font style="vertical-align: inherit;">，则调用<a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update">update</a> () 和</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#repaint"><font style="vertical-align: inherit;">repaint</font></a><font style="vertical-align: inherit;"> () 无效。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性为</font><code>true</code><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">setUpdatesEnabled() 通常用于在短时间内禁用更新，例如避免在大更改期间屏幕闪烁。在 Qt 中，组件通常不会产生屏幕闪烁，但在 X11 上，当组件在被其他组件替换之前被隐藏时，服务器可能会擦除屏幕上的区域。禁用更新可以解决这个问题。</font></p>
<p><font style="vertical-align: inherit;">例<span lang="zh-cn">如</span>：</font></p>
<pre class="cpp">

  setUpdatesEnabled(<span class="keyword">false</span>);
  bigVisualChanges();
  setUpdatesEnabled(<span class="keyword">true</span>);

</pre>
<p><font style="vertical-align: inherit;">禁用组件会隐式禁用其所有子组件。启用组件会启用</font><i><font style="vertical-align: inherit;">除</font></i><font style="vertical-align: inherit;">顶级组件或已明确禁用的组件<i>之外的</i>所有子组件。重新启用更新隐式调用组件上的</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update"><font style="vertical-align: inherit;">update</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>updatesEnabled</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setUpdatesEnabled</b></span>(bool <i>enable</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#paintEvent">paintEvent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@updatesEnabled -->
<!-- $$$visible-prop$$$isVisible$$$setVisiblebool -->
<h3 class="fn" id="visible-prop"><a name="visible-prop"></a><span class="name">visible</span> : <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件是否可见</font></p>
<p><font style="vertical-align: inherit;">如果窗口之前的所有父组件都可见，则调用 setVisible(true) 或</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">show</font></a><font style="vertical-align: inherit;"> () 将组件设置为可见状态。如果祖先不可见，则在显示其所有祖先之前，组件不会变得可见。如果它的大小或位置发生了变化，Qt 保证一个组件在它显示之前获得移动和调整大小事件。如果组件尚未调整大小，Qt 将使用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#adjustSize"><font style="vertical-align: inherit;">adjustSize</font></a><font style="vertical-align: inherit;"> ()将组件的大小调整为有用的默认值。</font></p>
<p><font style="vertical-align: inherit;">调用 setVisible(false) 或</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#hide"><font style="vertical-align: inherit;">hide</font></a><font style="vertical-align: inherit;"> () 会显式隐藏组件。一个显式隐藏的组件永远不会变得可见，即使它的所有祖先都变得可见，除非你显示它。</font></p>
<p><font style="vertical-align: inherit;">组件在其可见性状态更改时接收显示和隐藏事件。在隐藏和显示事件之间，无需浪费 CPU 周期来准备或向用户显示信息。例如，视频应用程序可能只是停止生成新帧。</font></p>
<p><font style="vertical-align: inherit;"><span lang="zh-cn">当组件</span>碰巧被屏幕上的其他窗口遮挡<span lang="zh-cn">时，也是被认为</span>是可见的。这同样适用于图标化窗口和存在于另一个虚拟桌面上的窗口（在支持此概念的平台上）。当窗口系统改变其映射状态时，组件接收自发显示和隐藏事件，例如，当用户最小化窗口时自发隐藏事件，以及当窗口再次恢复时自发显示事件。</font></p>
<p><font style="vertical-align: inherit;">您几乎不需要重新实现 setVisible() 函数。如果您需要在显示组件之前更改某些设置，请改用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#showEvent"><font style="vertical-align: inherit;">showEvent</font></a><font style="vertical-align: inherit;"> ()。如果您需要进行一些延迟初始化，请使用传递给</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#event"><font style="vertical-align: inherit;">event</font></a><font style="vertical-align: inherit;"> () 函数的<span lang="zh-cn">Polish</span>事件。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isVisible</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> virtual void </td><td class="memItemRight bottomAlign"><span class="name"><b>setVisible</b></span>(bool <i>visible</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#isHidden">isHidden</a>(), <a href="qwidget.html#isVisibleTo">isVisibleTo</a>(), <a href="qwidget.html#minimized-prop">isMinimized</a>(), <a href="qwidget.html#showEvent">showEvent</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#hideEvent">hideEvent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@visible -->
<!-- $$$whatsThis-prop$$$whatsThis$$$setWhatsThisconstQString& -->
<h3 class="fn" id="whatsThis-prop"><a name="whatsThis-prop"></a><span class="name">whatsThis</span> : <span class="type"><a href="../qtcore/qstring.html">QString</a></span></h3>
<p><font style="vertical-align: inherit;">此属性包含组件的“这是什么”帮助文本。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个空字符串。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><span class="name"><b>whatsThis</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWhatsThis</b></span>(<i>const QString &amp;</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwhatsthis.html">QWhatsThis</a>, <a href="qwidget.html#toolTip-prop">QWidget::toolTip</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#statusTip-prop">QWidget::statusTip</a><span lang="zh-cn">。</span></p>
<!-- @@@whatsThis -->
<!-- $$$width-prop$$$width -->
<h3 class="fn" id="width-prop"><a name="width-prop"></a><span class="name">width</span> : const <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件的宽度，不包括任何窗口框架</font></p>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">不要使用此功能在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qdesktopwidget.html"><font style="vertical-align: inherit;">多屏桌面</font></a><font style="vertical-align: inherit;">上查找屏幕的宽度。有关详细信息，请阅读</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qdesktopwidget.html#screen-geometry"><font style="vertical-align: inherit;">此注释</font></a><font style="vertical-align: inherit;">。</font></p><p><font style="vertical-align: inherit;">默认情况下，此属性包含一个取决于用户平台和屏幕几何形状的值。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>width</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#height-prop">height</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#size-prop">size</a><span lang="zh-cn">。</span></p>
<!-- @@@width -->
<!-- $$$windowFilePath-prop$$$windowFilePath$$$setWindowFilePathconstQString& -->
<h3 class="fn" id="windowFilePath-prop"><a name="windowFilePath-prop"></a><span class="name">windowFilePath</span> : <span class="type"><a href="../qtcore/qstring.html">QString</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存与组件关联的文件路径</font></p>
<p><font style="vertical-align: inherit;">这个属性只对windows有意义。它将文件路径与窗口相关联。如果你设置了文件路径，但没有设置窗口标题，Qt将窗口标题设置为指定路径的文件名，使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qfileinfo.html#fileName"><font style="vertical-align: inherit;">QFileInfo::fileName</font></a><font style="vertical-align: inherit;"> ()获取。</font></p>
<p><font style="vertical-align: inherit;">如果在任何时候设置了窗口标题，则窗口标题优先并且将显示而不是文件路径字符串。</font></p>
<p><font style="vertical-align: inherit;">此外，在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtdoc/internationalization.html#macos"><font style="vertical-align: inherit;">macOS 上</font></a><font style="vertical-align: inherit;">，这有一个额外的好处，它为窗口设置</font><a href="http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuidelines/XHIGWindows/chapter_17_section_3.html"><font style="vertical-align: inherit;">代理图标</font></a><font style="vertical-align: inherit;">，假设文件路径存在。</font></p>
<p><font style="vertical-align: inherit;">如果未设置文件路径，则此属性包含一个空字符串。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性包含一个空字符串。</font></p>
<p><font style="vertical-align: inherit;">这个属性是在 Qt 4.4 中引入的。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><span class="name"><b>windowFilePath</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWindowFilePath</b></span>(const QString &amp;<i>filePath</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#windowTitle-prop">windowTitle</a> 
<span lang="zh-cn">和 </span><a href="qwidget.html#windowIcon-prop">windowIcon</a><span lang="zh-cn">。</span></p>
<!-- @@@windowFilePath -->
<!-- $$$windowFlags-prop$$$windowFlags$$$setWindowFlagsQt::WindowFlags -->
<h3 class="fn" id="windowFlags-prop"><a name="windowFlags-prop"></a><span class="name">windowFlags</span> : <span class="type"><a href="../qtcore/qt.html#WindowType-enum">Qt::WindowFlags</a></span></h3>
<p><font style="vertical-align: inherit;">窗口标志是一个类型（例如</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::Dialog</font></a><font style="vertical-align: inherit;">）和零个或多个窗口系统提示（例</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::FramelessWindowHint</font></a><font style="vertical-align: inherit;">）的组合。</font></p>
<p><font style="vertical-align: inherit;">如果组件的类型为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::Widget</font></a><font style="vertical-align: inherit;">或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::SubWindow</font></a><font style="vertical-align: inherit;">并成为窗口（</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::Window</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::Dialog</font></a><font style="vertical-align: inherit;">等），则将其放置在桌面上的位置 (0, 0)。如果组件是一个窗口并成为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::Widget</font></a><font style="vertical-align: inherit;">或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::SubWindow</font></a><font style="vertical-align: inherit;">，则它被放置在相对于其父组件的位置 (0, 0)。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">此函数在更改窗口的标志时调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setParent"><font style="vertical-align: inherit;">setParent</font></a><font style="vertical-align: inherit;"> ()，导致组件被隐藏。您必须调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">show</font></a><font style="vertical-align: inherit;"> () 使组件再次可见<span lang="zh-cn">。</span></font></p><p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> Qt::WindowFlags </td><td class="memItemRight bottomAlign"><span class="name"><b>windowFlags</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWindowFlags</b></span>(Qt::WindowFlags <i>type</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#windowType">windowType</a>(), <a href="qwidget.html#setWindowFlag">setWindowFlag</a>(),
<span lang="zh-cn">和</span> <a href="qtwidgets-widgets-windowflags-example.html">
<span lang="zh-cn">窗口标志示例</span></a><span lang="zh-cn">。</span></p>
<!-- @@@windowFlags -->
<!-- $$$windowIcon-prop$$$windowIcon$$$setWindowIconconstQIcon&$$$windowIconChangedconstQIcon& -->
<h3 class="fn" id="windowIcon-prop"><a name="windowIcon-prop"></a><span class="name">windowIcon</span> : <span class="type"><a href="../qtgui/qicon.html">QIcon</a></span></h3>
<p><font style="vertical-align: inherit;">此属性包含组件的图标</font></p>
<p><font style="vertical-align: inherit;">这个属性只对窗口有意义。如果没有设置图标，windowIcon() 返回应用程序图标 ( </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qapplication.html#windowIcon-prop"><font style="vertical-align: inherit;">QApplication::windowIcon</font></a><font style="vertical-align: inherit;"> ())。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QIcon </td><td class="memItemRight bottomAlign"><span class="name"><b>windowIcon</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWindowIcon</b></span>(const QIcon &amp;<i>icon</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#windowIconChanged">windowIconChanged</a></b></span>(const QIcon &amp;<i>icon</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#windowTitle-prop">windowTitle</a><span lang="zh-cn">。</span></p>
<!-- @@@windowIcon -->
<!-- $$$windowModality-prop$$$windowModality$$$setWindowModalityQt::WindowModality -->
<h3 class="fn" id="windowModality-prop"><a name="windowModality-prop"></a><span class="name">windowModality</span> : <span class="type"><a href="../qtcore/qt.html#WindowModality-enum">Qt::WindowModality</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存哪些窗口被模态组件<span lang="zh-cn">阻塞</span></font></p>
<p><font style="vertical-align: inherit;">这个属性只对窗口有意义。模态组件可防止其他窗口中的组件获取输入。此属性的值控制当组件可见时阻止哪些窗口。在窗口可见时更改此属性无效；您必须先</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#hide"><font style="vertical-align: inherit;">隐藏</font></a><font style="vertical-align: inherit;">() 
组件，然后再次</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">显示</font></a><font style="vertical-align: inherit;">() 它。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowModality-enum"><font style="vertical-align: inherit;">Qt::NonModal</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">这个属性是在 Qt 4.1 中引入的。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> Qt::WindowModality </td><td class="memItemRight bottomAlign"><span class="name"><b>windowModality</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWindowModality</b></span>(Qt::WindowModality <i>windowModality</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#isWindow">isWindow</a>(), <a href="qwidget.html#modal-prop">QWidget::modal</a>,
<span lang="zh-cn">和 </span><a href="qdialog.html">QDialog</a><span lang="zh-cn">。</span></p>
<!-- @@@windowModality -->
<!-- $$$windowModified-prop$$$isWindowModified$$$setWindowModifiedbool -->
<h3 class="fn" id="windowModified-prop"><a name="windowModified-prop"></a><span class="name">windowModified</span> : <span class="type">bool</span></h3>
<p><font style="vertical-align: inherit;">此属性保存窗口中显示的文档是否有未保存的更改</font></p>
<p><font style="vertical-align: inherit;">修改后的窗口是内容已更改但尚未保存到磁盘的窗口。此标志将具有因平台而异的不同效果。在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtdoc/internationalization.html#macos"><font style="vertical-align: inherit;">macOS 上</font></a><font style="vertical-align: inherit;">，关闭按钮的外观会有所修改；在其他平台上，窗口标题将带有“*”（星号）。</font></p>
<p><font style="vertical-align: inherit;">窗口标题必须包含一个“[*]”占位符，它指示“*”应该出现的位置。通常，它应该出现在文件名之后（例如，“document1.txt[*] - 文本编辑器”）。如果未修改窗口，则简单地删除占位符。</font></p>
<p><font style="vertical-align: inherit;">请注意，如果组件设置为已修改，则其所有祖先也将设置为已修改。但是，如果您调用</font><code>setWindowModified(false)</code><font style="vertical-align: inherit;">一个组件，这将不会传播到其父级，因为父级的其他子级可能已被修改。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>isWindowModified</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWindowModified</b></span>(<i>bool</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#windowTitle-prop">windowTitle</a>, <a href="qtwidgets-mainwindows-application-example.html">Application 
<span lang="zh-cn">示例</span></a>, <a href="qtwidgets-mainwindows-sdi-example.html">SDI 
<span lang="zh-cn">示例</span></a>, <span lang="zh-cn">和 </span>
<a href="qtwidgets-mainwindows-mdi-example.html">MDI <span lang="zh-cn">示例</span></a>.</p>
<!-- @@@windowModified -->
<!-- $$$windowOpacity-prop$$$windowOpacity$$$setWindowOpacityqreal -->
<h3 class="fn" id="windowOpacity-prop"><a name="windowOpacity-prop"></a><span class="name">windowOpacity</span> : <span class="type">double</span></h3>
<p><font style="vertical-align: inherit;">此属性保存窗口的不透明度级别。</font></p>
<p><font style="vertical-align: inherit;">明度的有效范围是从 1.0（完全不透明）到 0.0（完全透明）。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性的值为 1.0。</font></p>
<p><font style="vertical-align: inherit;">此功能在支持 Composite 扩展的嵌入式 Linux、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtdoc/internationalization.html#macos"><font style="vertical-align: inherit;">macOS</font></a><font style="vertical-align: inherit;">、Windows 和 X11 平台。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">在 X11 上，您需要运行复合管理器，并且您正在使用的窗口管理器需要支持 X11 特定的 _NET_WM_WINDOW_OPACITY 原子。</font></p><p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">将此属性从不透明更改为透明可能会发出需要在正确显示窗口之前处理的绘制事件。这主要影响 QPixmap::grabWindow() 的使用。另请注意，半透明窗口的更新和调整大小明显慢于不透明窗口。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> qreal </td><td class="memItemRight bottomAlign"><span class="name"><b>windowOpacity</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWindowOpacity</b></span>(qreal <i>level</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#setMask">setMask</a>()<span lang="zh-cn">。</span></p>
<!-- @@@windowOpacity -->
<!-- $$$windowTitle-prop$$$windowTitle$$$setWindowTitleconstQString&$$$windowTitleChangedconstQString& -->
<h3 class="fn" id="windowTitle-prop"><a name="windowTitle-prop"></a><span class="name">windowTitle</span> : <span class="type"><a href="../qtcore/qstring.html">QString</a></span></h3>
<p><font style="vertical-align: inherit;">此属性保存窗口标题（标题）</font></p>
<p><font style="vertical-align: inherit;">此属性仅对顶级组件有意义，例如窗口和对话框。如果未设置标题，则标题基于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#windowFilePath-prop"><font style="vertical-align: inherit;">windowFilePath</font></a><font style="vertical-align: inherit;">。如果这些都没有设置，则标题是一个空字符串。</font></p>
<p><font style="vertical-align: inherit;">如果您使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#windowModified-prop"><font style="vertical-align: inherit;">windowModified</font></a><font style="vertical-align: inherit;">机制，则窗口标题必须包含一个“[*]”占位符，它指示“*”应该出现的位置。通常，它应该出现在文件名之后（例如，“document1.txt[*] - 文本编辑器”）。如果</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#windowModified-prop"><font style="vertical-align: inherit;">windowModified</font></a><font style="vertical-align: inherit;">属性是</font><code>false</code><font style="vertical-align: inherit;">（默认值），则简单地删除占位符。</font></p>
<p><font style="vertical-align: inherit;">在某些桌面平台（包括 Windows 和 Unix）上，应用程序名称（来自</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qguiapplication.html#applicationDisplayName-prop"><font style="vertical-align: inherit;">QGuiApplication::applicationDisplayName</font></a><font style="vertical-align: inherit;">）会添加到窗口标题的末尾（如果已设置）。这是由 QPA 插件完成的，因此它会显示给用户，但不是 windowTitle 字符串的一部分。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><span class="name"><b>windowTitle</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWindowTitle</b></span>(<i>const QString &amp;</i>)</td></tr>
</table></div>
<p><b>Notifier signal:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b><a href="qwidget.html#windowTitleChanged">windowTitleChanged</a></b></span>(const QString &amp;<i>title</i>)</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#windowIcon-prop">windowIcon</a>, <a href="qwidget.html#windowModified-prop">windowModified</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#windowFilePath-prop">windowFilePath</a><span lang="zh-cn">。</span></p>
<!-- @@@windowTitle -->
<!-- $$$x-prop$$$x -->
<h3 class="fn" id="x-prop"><a name="x-prop"></a><span class="name">x</span> : const <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件相对于其父级的 x 坐标，包括任何窗口框架</font></p>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性的值为 0。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>x</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#y-prop">y</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#pos-prop">pos</a><span lang="zh-cn">。</span></p>
<!-- @@@x -->
<!-- $$$y-prop$$$y -->
<h3 class="fn" id="y-prop"><a name="y-prop"></a><span class="name">y</span> : const <span class="type">int</span></h3>
<p><font style="vertical-align: inherit;">此属性保存组件相对于其父级的 y 坐标，包括任何窗口框架</font></p>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，此属性的值为 0。</font></p>
<p><b>访问函数：</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>y</b></span>() const</td></tr>
</table></div>
<p><b>请参考 </b><a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#x-prop">x</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#pos-prop">pos</a><span lang="zh-cn">。</span></p>
<!-- @@@y -->
</div>
<div class="func">
<h2><span lang="zh-cn">成员函数文档</span></h2>
<!-- $$$QWidget[overload1]$$$QWidgetQWidget*Qt::WindowFlags -->
<h3 class="fn" id="QWidget"><a name="QWidget"></a>QWidget::<span class="name">QWidget</span>(<span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>parent</i> = nullptr, <span class="type"><a href="../qtcore/qt.html#WindowType-enum">Qt::WindowFlags</a></span> <i>f</i> = ...)</h3>
<p><font style="vertical-align: inherit;">构造一个组件，它是</font><i><font style="vertical-align: inherit;">parent</font></i><font style="vertical-align: inherit;">的子组件，组件标志设置为</font><i><font style="vertical-align: inherit;">f</font></i><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">parent</font></i><font style="vertical-align: inherit;">为 0，则新组件将成为一个窗口。如果</font><i><font style="vertical-align: inherit;">parent</font></i><font style="vertical-align: inherit;">是另一个组件，则此组件将成为</font><i><font style="vertical-align: inherit;">parent</font></i><font style="vertical-align: inherit;">内的子窗口。删除</font><i><font style="vertical-align: inherit;">其父级</font></i><font style="vertical-align: inherit;">时，新组件也将被删除。</font></p>
<p><font style="vertical-align: inherit;">组件标志参数</font><i><font style="vertical-align: inherit;">f</font></i><font style="vertical-align: inherit;">通常为 0，但可以设置它来自定义窗口的框架（即</font><i><font style="vertical-align: inherit;">父级</font></i><font style="vertical-align: inherit;">必须为 0）。要自定义框架，请使用由任何</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">窗口标志</font></a><font style="vertical-align: inherit;">的按位 OR 组成的值。</font></p>
<p><font style="vertical-align: inherit;">如果将子组件添加到已经可见的组件，则必须明确显示子组件以使其可见。</font></p>
<p><font style="vertical-align: inherit;">请注意，X11 版本的 Qt 可能无法在所有系统上提供所有样式标志组合。这是因为在 X11 上，Qt 只能询问窗口管理器，而窗口管理器可以覆盖应用程序的设置。在 Windows 上，Qt 可以设置任何你想要的标志。</font></p>
<p><b>请参考 </b><a href="qwidget.html#windowFlags-prop">windowFlags</a><span lang="zh-cn">。</span></p>
<!-- @@@QWidget -->
<!-- $$$~QWidget[overload1]$$$~QWidget -->
<h3 class="fn" id="dtor.QWidget"><a name="dtor.QWidget"></a><code>[virtual] </code>QWidget::<span class="name">~QWidget</span>()</h3>
<p><font style="vertical-align: inherit;">销毁组件。</font></p>
<p><font style="vertical-align: inherit;">首先删除所有此组件的子组件。如果此组件是主组件，则应用程序退出。</font></p>
<!-- @@@~QWidget -->
<!-- $$$actionEvent[overload1]$$$actionEventQActionEvent* -->
<h3 class="fn" id="actionEvent"><a name="actionEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">actionEvent</span>(<span class="type"><a href="../qtgui/qactionevent.html">QActionEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">每当组件的<span lang="zh-cn">动作</span>发生更改时，都会使用给定的<i>event</i> 调用此事件处理程序。</font></p>
<p><b>请参考 </b><a href="qwidget.html#addAction">addAction</a>(), <a href="qwidget.html#insertAction">insertAction</a>(), <a href="qwidget.html#removeAction">removeAction</a>(), <a href="qwidget.html#actions">actions</a>(),
<span lang="zh-cn">和 </span><a href="../qtgui/qactionevent.html">QActionEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@actionEvent -->
<!-- $$$actions[overload1]$$$actions -->
<h3 class="fn" id="actions"><a name="actions"></a><span class="type"><a href="../qtcore/qlist.html">QList</a></span>&lt;<span class="type"><a href="qaction.html">QAction</a></span> *&gt; QWidget::<span class="name">actions</span>() const</h3>
<p><font style="vertical-align: inherit;">返回此组件<span lang="zh-cn">动作</span>的（可能为空）列表。</font></p>
<p><b>请参考 </b><a href="qwidget.html#contextMenuPolicy-prop">contextMenuPolicy</a>, <a href="qwidget.html#insertAction">insertAction</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#removeAction">removeAction</a>()<span lang="zh-cn">。</span></p>
<!-- @@@actions -->
<!-- $$$activateWindow[overload1]$$$activateWindow -->
<h3 class="fn" id="activateWindow"><a name="activateWindow"></a><span class="type">void</span> QWidget::<span class="name">activateWindow</span>()</h3>
<p><font style="vertical-align: inherit;">将包含此组件的顶级组件设置为活动窗口。</font></p>
<p><font style="vertical-align: inherit;">活动窗口是具有键盘输入焦点的可见顶级窗口。</font></p>
<p><font style="vertical-align: inherit;">此函数执行与在顶级窗口的标题栏上单击鼠标相同的操作。在 X11 上，结果取决于窗口管理器。如果您想确保窗口也堆叠在顶部，您还应该调用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#raise"><font style="vertical-align: inherit;">raise</font></a><font style="vertical-align: inherit;"> ()。注意窗口必须是可见的，否则 activateWindow() 不起作用。</font></p>
<p><font style="vertical-align: inherit;">在 Windows 上，如果您在应用程序当前不是活动窗口时调用它，那么它不会使其成为活动窗口。它将更改任务栏条目的颜色以指示窗口已以某种方式更改。这是因为 Microsoft 不允许应用程序中断用户当前在另一个应用程序中执行的操作。</font></p>
<p><b>请参考 </b><a href="qwidget.html#isActiveWindow-prop">isActiveWindow</a>(), <a href="qwidget.html#window">window</a>(), <a href="qwidget.html#show">show</a>(),
<span lang="zh-cn">和 </span>
<a href="../qtplatformheaders/qwindowswindowfunctions.html#setWindowActivationBehavior">QWindowsWindowFunctions::setWindowActivationBehavior</a>()<span lang="zh-cn">。</span></p>
<!-- @@@activateWindow -->
<!-- $$$addAction[overload1]$$$addActionQAction* -->
<h3 class="fn" id="addAction"><a name="addAction"></a><span class="type">void</span> QWidget::<span class="name">addAction</span>(<span class="type"><a href="qaction.html">QAction</a></span> *<i>action</i>)</h3>
<p><font style="vertical-align: inherit;">将动作<i>action</i>附加到此组件的动作列表中。</font></p>
<p><font style="vertical-align: inherit;">&nbsp;QWidget 都有一个</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qaction.html"><font style="vertical-align: inherit;">QAction</font></a><font style="vertical-align: inherit;">列表，但是它们可以用许多不同的方式以图形方式表示。</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qaction.html"><font style="vertical-align: inherit;">QAction</font></a><font style="vertical-align: inherit;">列表（由</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#actions"><font style="vertical-align: inherit;">actions</font></a><font style="vertical-align: inherit;"> ()返回）的默认用途是创建上下文</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qmenu.html"><font style="vertical-align: inherit;">QMenu</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">一个</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><span lang="zh-cn">只</span><font style="vertical-align: inherit;"><span lang="zh-cn">应该拥有</span>每个动作<span lang="zh-cn">的一个实例</span>，<span lang="zh-cn">而不应该有多个，避免重复动作。</span></font></p>
<p><i><font style="vertical-align: inherit;">action</font></i><font style="vertical-align: inherit;">的所有权不会转移到这个</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#removeAction">removeAction</a>(), <a href="qwidget.html#insertAction">insertAction</a>(), <a href="qwidget.html#actions">actions</a>(),
<span lang="zh-cn">和 </span><a href="qmenu.html">QMenu</a><span lang="zh-cn">。</span></p>
<!-- @@@addAction -->
<!-- $$$addActions[overload1]$$$addActionsQList<QAction*> -->
<h3 class="fn" id="addActions"><a name="addActions"></a><span class="type">void</span> QWidget::<span class="name">addActions</span>(<span class="type"><a href="../qtcore/qlist.html">QList</a></span>&lt;<span class="type"><a href="qaction.html">QAction</a></span> *&gt; <i>actions</i>)</h3>
<p><font style="vertical-align: inherit;">将操作<i>actions<span lang="zh-cn">
</span></i>附加到此组件的<span lang="zh-cn">动作</span>列表。</font></p>
<p><b>请参考 </b><a href="qwidget.html#removeAction">removeAction</a>(), <a href="qmenu.html">QMenu</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#addAction">addAction</a>()<span lang="zh-cn">。</span></p>
<!-- @@@addActions -->
<!-- $$$adjustSize[overload1]$$$adjustSize -->
<h3 class="fn" id="adjustSize"><a name="adjustSize"></a><span class="type">void</span> QWidget::<span class="name">adjustSize</span>()</h3>
<p><font style="vertical-align: inherit;">调整组件的大小以适合其内容。</font></p>
<p><font style="vertical-align: inherit;">如果有效，则此函数使用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeHint-prop"><font style="vertical-align: inherit;">sizeHint</font></a><font style="vertical-align: inherit;"> ()，即尺寸提示的宽度和高度 &gt;= 0。否则，它将大小设置为覆盖所有子组件的子矩形（所有子组件矩形的联合）。</font></p>
<p><font style="vertical-align: inherit;">对于 Windows，还考虑了屏幕尺寸。如果</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeHint-prop"><font style="vertical-align: inherit;">sizeHint</font></a><font style="vertical-align: inherit;"> () 小于 (200, 100) 并且大小策略正在</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qsizepolicy.html#Policy-enum"><font style="vertical-align: inherit;"><span lang="zh-cn">expanding(扩</span>展</font></a><span lang="zh-cn">）</span><font style="vertical-align: inherit;">，则窗口将至少为 (200, 100)。窗口的最大尺寸是屏幕宽度和高度的 2/3。</font></p>
<p><b>请参考 </b><a href="qwidget.html#sizeHint-prop">sizeHint</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#childrenRect-prop">childrenRect</a>()<span lang="zh-cn">。</span></p>
<!-- @@@adjustSize -->
<!-- $$$backgroundRole[overload1]$$$backgroundRole -->
<h3 class="fn" id="backgroundRole"><a name="backgroundRole"></a><span class="type"><a href="../qtgui/qpalette.html#ColorRole-enum">QPalette::ColorRole</a></span> QWidget::<span class="name">backgroundRole</span>() const</h3>
<p><font style="vertical-align: inherit;">返回组件的背景角色。</font></p>
<p><font style="vertical-align: inherit;">背景角色定义了用于渲染背景的组件</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#palette-prop"><font style="vertical-align: inherit;">调色板</font></a><font style="vertical-align: inherit;">中的画笔。</font></p>
<p><font style="vertical-align: inherit;">背景角色定义了用于渲染背景的组件</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#palette-prop"><font style="vertical-align: inherit;">调色板</font></a><font style="vertical-align: inherit;">中的画笔。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setBackgroundRole">setBackgroundRole</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#foregroundRole">foregroundRole</a>()<span lang="zh-cn">。</span></p>
<!-- @@@backgroundRole -->
<!-- $$$backingStore[overload1]$$$backingStore -->
<h3 class="fn" id="backingStore"><a name="backingStore"></a><span class="type"><a href="../qtgui/qbackingstore.html">QBackingStore</a></span> *QWidget::<span class="name">backingStore</span>() const</h3>
<p><font style="vertical-align: inherit;">返回此组件将被绘制到的</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtgui/qbackingstore.html"><font style="vertical-align: inherit;">QBackingStore</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 5.0 中引入的。</font></p>
<!-- @@@backingStore -->
<!-- $$$changeEvent[overload1]$$$changeEventQEvent* -->
<h3 class="fn" id="changeEvent"><a name="changeEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">changeEvent</span>(<span class="type"><a href="../qtcore/qevent.html">QEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">可以重新实现此事件处理程序以处理状态更改。</font></p>
<p><font style="vertical-align: inherit;">可以通过提供的<i>event<span lang="zh-cn"> 检</span></i>索此事件中正在更改的状态。</font></p>
<p><font style="vertical-align: inherit;">更改事件包括：</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::ToolBarChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::ActivationChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::EnabledChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::FontChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::StyleChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::PaletteChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::WindowTitleChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::IconTextChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::ModifiedChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent ::MouseTrackingChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::ParentChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::WindowStateChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::LanguageChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::LocaleChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::LayoutDirectionChange</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::ReadOnlyChange</font></a><font style="vertical-align: inherit;">。</font></p>
<!-- @@@changeEvent -->
<!-- $$$childAt[overload1]$$$childAtintint -->
<h3 class="fn" id="childAt"><a name="childAt"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">childAt</span>(<span class="type">int</span> <i>x</i>, <span class="type">int</span> <i>y</i>) const</h3>
<p><font style="vertical-align: inherit;">返回组件坐标系中位置 ( </font><i><font style="vertical-align: inherit;">x</font></i><font style="vertical-align: inherit;"> , </font><i><font style="vertical-align: inherit;">y</font></i><font style="vertical-align: inherit;"> )处的可见子组件。如果指定位置没有可见的子组件，则函数返回</font><code>nullptr</code><font style="vertical-align: inherit;">。</font></p>
<!-- @@@childAt -->
<!-- $$$childAt$$$childAtconstQPoint& -->
<h3 class="fn" id="childAt-1"><a name="childAt-1"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">childAt</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>p</i>) const</h3>
<p><font style="vertical-align: inherit;">这是一个<span lang="zh-cn">重载函数</span>。</font></p>
<p><font style="vertical-align: inherit;">返回组件自己坐标系中</font><i><font style="vertical-align: inherit;">p</font></i><font style="vertical-align: inherit;">点处的可见子组件。</font></p>
<!-- @@@childAt -->
<!-- $$$clearFocus[overload1]$$$clearFocus -->
<h3 class="fn" id="clearFocus"><a name="clearFocus"></a><span class="type">void</span> QWidget::<span class="name">clearFocus</span>()</h3>
<p><font style="vertical-align: inherit;">从组件获取键盘输入焦点。</font></p>
<p><font style="vertical-align: inherit;">如果组件具有活动焦点，则向该组件发送</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusOutEvent"><font style="vertical-align: inherit;">焦点移出事件</font></a><font style="vertical-align: inherit;">以告知它已失去焦点。</font></p>
<p><font style="vertical-align: inherit;">这个组件必须启用焦点设置才能获得键盘输入焦点，即它必须调用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusPolicy-prop"><font style="vertical-align: inherit;">setFocusPolicy</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><b>请参考 </b><a href="qwidget.html#focus-prop">hasFocus</a>(), <a href="qwidget.html#setFocus-1">setFocus</a>(), <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>(),
<span lang="zh-cn">和 </span><a href="qapplication.html#focusWidget">QApplication::focusWidget</a>()<span lang="zh-cn">。</span></p>
<!-- @@@clearFocus -->
<!-- $$$clearMask[overload1]$$$clearMask -->
<h3 class="fn" id="clearMask"><a name="clearMask"></a><span class="type">void</span> QWidget::<span class="name">clearMask</span>()</h3>
<p><font style="vertical-align: inherit;">删除由</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setMask"><font style="vertical-align: inherit;">setMask</font></a><font style="vertical-align: inherit;"> ()设置的任何掩码。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setMask">setMask</a>().</p>
<!-- @@@clearMask -->
<!-- $$$close[overload1]$$$close -->
<h3 class="fn" id="close"><a name="close"></a><code>[slot] </code><span class="type">bool</span> QWidget::<span class="name">close</span>()</h3>
<p><font style="vertical-align: inherit;">关闭此组件。返回</font><code>true</code><font style="vertical-align: inherit;">组件是否已关闭；否则返回</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">首先它向组件发送一个</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtgui/qcloseevent.html"><font style="vertical-align: inherit;">QCloseEvent</font></a><font style="vertical-align: inherit;">。如果组件<a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#accept">接受</a>关闭事件，它就会被</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#hide"><font style="vertical-align: inherit;">隐藏</font></a><font style="vertical-align: inherit;">。如果它<a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#ignore">忽略</a>该事件，则什么也不会发生。<a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#closeEvent">QWidget::closeEvent</a> ()的默认实现接受关闭事件。</font></p>
<p><font style="vertical-align: inherit;">如果组件具有</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum"><font style="vertical-align: inherit;">Qt::WA_DeleteOnClose</font></a><font style="vertical-align: inherit;">标志，则组件也会被删除。无论组件是否可见，都会向组件传递关闭事件。</font></p>
<p><font style="vertical-align: inherit;"><span lang="zh-cn">当最后可见的主窗口具有<a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WA_QuitOnClose</a>属性集并且关闭，<a href="../qtgui/qguiapplication.html#lastWindowClosed">QApplication::lastWindowClosed</a>（）信号将被发射。默认情况下，为所有组件设置此属性，但瞬态窗口除外，例如闪屏、工具窗口和弹出菜单。</span></font></p>
<!-- @@@close -->
<!-- $$$closeEvent[overload1]$$$closeEventQCloseEvent* -->
<h3 class="fn" id="closeEvent"><a name="closeEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">closeEvent</span>(<span class="type"><a href="../qtgui/qcloseevent.html">QCloseEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">当 Qt 从窗口系统接收到对顶级组件的窗口关闭请求时，将使用给定的<i>event</i>调用此事件处理程序。</font></p>
<p><font style="vertical-align: inherit;">默认情况下，接受事件并关闭组件。您可以重新实现此功能以更改组件响应窗口关闭请求的方式。例如，您可以通过对所有事件调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#ignore"><font style="vertical-align: inherit;">ignore()</font></a><font style="vertical-align: inherit;">来防止窗口关闭。</font></p>
<p><font style="vertical-align: inherit;">主窗口应用程序通常使用此函数的重新实现来检查用户的工作是否已保存并在关闭前请求许可。例如，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qtwidgets-mainwindows-application-example.html"><font style="vertical-align: inherit;">应用示例</font></a><font style="vertical-align: inherit;">使用一个辅助函数来确定是否关闭窗口：</font></p>
<pre class="cpp">

  <span class="type">void</span> MainWindow<span class="operator">::</span>closeEvent(<span class="type"><a href="../qtgui/qcloseevent.html">QCloseEvent</a></span> <span class="operator">*</span>event)
  {
      <span class="keyword">if</span> (maybeSave()) {
          writeSettings();
          event<span class="operator">-</span><span class="operator">&gt;</span>accept();
      } <span class="keyword">else</span> {
          event<span class="operator">-</span><span class="operator">&gt;</span>ignore();
      }
  }

</pre>
<p><b>请参考 </b><a href="qwidget.html#event">event</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#close">close</a>(), <a href="../qtgui/qcloseevent.html">QCloseEvent</a>,
<span lang="zh-cn">和 </span>
<a href="qtwidgets-mainwindows-application-example.html">Application Example</a><span lang="zh-cn">。</span></p>
<!-- @@@closeEvent -->
<!-- $$$contentsMargins[overload1]$$$contentsMargins -->
<h3 class="fn" id="contentsMargins"><a name="contentsMargins"></a><span class="type"><a href="../qtcore/qmargins.html">QMargins</a></span> QWidget::<span class="name">contentsMargins</span>() const</h3>
<p><font style="vertical-align: inherit;">contentsMargins 函数返回组件的内容边距。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.6 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#getContentsMargins">getContentsMargins</a>(), <a href="qwidget.html#setContentsMargins">setContentsMargins</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#contentsRect">contentsRect</a>()<span lang="zh-cn">。</span></p>
<!-- @@@contentsMargins -->
<!-- $$$contentsRect[overload1]$$$contentsRect -->
<h3 class="fn" id="contentsRect"><a name="contentsRect"></a><span class="type"><a href="../qtcore/qrect.html">QRect</a></span> QWidget::<span class="name">contentsRect</span>() const</h3>
<p><font style="vertical-align: inherit;">返回组件边距内的区域。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setContentsMargins">setContentsMargins</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#getContentsMargins">getContentsMargins</a>()<span lang="zh-cn">。</span></p>
<!-- @@@contentsRect -->
<!-- $$$contextMenuEvent[overload1]$$$contextMenuEventQContextMenuEvent* -->
<h3 class="fn" id="contextMenuEvent"><a name="contextMenuEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">contextMenuEvent</span>(<span class="type"><a href="../qtgui/qcontextmenuevent.html">QContextMenuEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于 <span lang="zh-cn">事件</span></font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现，以接收组件上下文菜单事件。</font></p>
<p><font style="vertical-align: inherit;">当组件的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#contextMenuPolicy-prop"><font style="vertical-align: inherit;">contextMenuPolicy</font></a><font style="vertical-align: inherit;">为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ContextMenuPolicy-enum"><font style="vertical-align: inherit;">Qt::DefaultContextMenu</font></a><font style="vertical-align: inherit;">时调用处理程序。</font></p>
<p><font style="vertical-align: inherit;">默认实现忽略上下文事件。有关更多详细信息，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qcontextmenuevent.html"><font style="vertical-align: inherit;">QContextMenuEvent</font></a><font style="vertical-align: inherit;">文档。</font></p>
<p><b>请参考 </b><a href="qwidget.html#event">event</a>(), <a href="../qtgui/qcontextmenuevent.html">QContextMenuEvent</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#customContextMenuRequested">customContextMenuRequested</a>()<span lang="zh-cn">。</span></p>
<!-- @@@contextMenuEvent -->
<!-- $$$create[overload1]$$$createWIdboolbool -->
<h3 class="fn" id="create"><a name="create"></a><code>[protected] </code><span class="type">void</span> QWidget::<span class="name">create</span>(<span class="type">WId</span> <i>window</i> = 0, <span class="type">bool</span> <i>initializeWindow</i> = true, <span class="type">bool</span> <i>destroyOldWindow</i> = true)</h3>
<p><font style="vertical-align: inherit;">创建一个新的组件窗口。</font></p>
<p><font style="vertical-align: inherit;">参数</font><i><font style="vertical-align: inherit;">window</font></i><font style="vertical-align: inherit;">在Qt 5中被忽略。请使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html#fromWinId"><font style="vertical-align: inherit;">QWindow::fromWinId</font></a><font style="vertical-align: inherit;"> ()创建一个包裹外部窗口的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html"><font style="vertical-align: inherit;">QWindow</font></a><font style="vertical-align: inherit;">并将其传递给</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#createWindowContainer"><font style="vertical-align: inherit;">QWidget::createWindowContainer</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">initializeWindow</font></i><font style="vertical-align: inherit;">为真，则<span lang="zh-cn">初始化</span>窗口（设置几何图形等）。如果</font><i><font style="vertical-align: inherit;">initializeWindow</font></i><font style="vertical-align: inherit;">为 false，则不执行任何初始化。此参数仅在</font><i><font style="vertical-align: inherit;">window</font></i><font style="vertical-align: inherit;">是有效窗口时才有意义。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">destroyOldWindow</font></i><font style="vertical-align: inherit;">为真，则销毁旧窗口。如果</font><i><font style="vertical-align: inherit;">destroyOldWindow</font></i><font style="vertical-align: inherit;">为 false，则您负责自己销毁窗口（使用平台本机代码）。</font></p>
<p><font style="vertical-align: inherit;">该</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget的</font></a><font style="vertical-align: inherit;">构造函数调用<span lang="zh-cn">create</span>（0,true,true) 来创建这个组件的窗口。</font></p>
<p><b>请参考 </b><a href="qwidget.html#createWindowContainer">createWindowContainer</a>()
<span lang="zh-cn">和 </span><a href="../qtgui/qwindow.html#fromWinId">QWindow::fromWinId</a>()<span lang="zh-cn">。</span></p>
<!-- @@@create -->
<!-- $$$createWindowContainer[overload1]$$$createWindowContainerQWindow*QWidget*Qt::WindowFlags -->
<h3 class="fn" id="createWindowContainer"><a name="createWindowContainer"></a><code>[static] </code><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">createWindowContainer</span>(<span class="type"><a href="../qtgui/qwindow.html">QWindow</a></span> *<i>window</i>, <span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>parent</i> = nullptr, <span class="type"><a href="../qtcore/qt.html#WindowType-enum">Qt::WindowFlags</a></span> <i>flags</i> = ...)</h3>
<p><font style="vertical-align: inherit;">创建一个</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">，可以将</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">window</span></font></i><font style="vertical-align: inherit;">嵌入到基于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">的应用程序中。</font></p>
<p><font style="vertical-align: inherit;">窗口容器被创建</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">parent</span></font></i><font style="vertical-align: inherit;">的子级并带有窗口标志</font><i><font style="vertical-align: inherit;">flags</font></i><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">一旦窗口被嵌入到容器中，容器将控制窗口的几何形状和可见性。不推荐在嵌入式窗口上显式调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html#setGeometry-1"><font style="vertical-align: inherit;">QWindow::setGeometry</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html#show"><font style="vertical-align: inherit;">QWindow::show</font></a><font style="vertical-align: inherit;"> () 或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html#hide"><font style="vertical-align: inherit;">QWindow::hide</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><font style="vertical-align: inherit;">容器接管</font><i><font style="vertical-align: inherit;">window 的</font></i><font style="vertical-align: inherit;">所有权。可以通过调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html#setParent"><font style="vertical-align: inherit;">QWindow::setParent</font></a><font style="vertical-align: inherit;"> ()从窗口容器中删除窗口。</font></p>
<p><font style="vertical-align: inherit;">窗口容器作为本机子窗口附加到它是其子级的顶级窗口。当窗口容器用作</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qabstractscrollarea.html"><font style="vertical-align: inherit;">QAbstractScrollArea</font></a><font style="vertical-align: inherit;">或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qmdiarea.html"><font style="vertical-align: inherit;">QMdiArea</font></a><font style="vertical-align: inherit;">的子<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qmdiarea.html">级时</a>，它将为其父链中的每个组件创建一个</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#native-widgets-vs-alien-widgets"><font style="vertical-align: inherit;">本机窗口</font></a><font style="vertical-align: inherit;">，以允许在此用例中正确堆叠和剪辑。为窗口容器创建本机窗口还允许正确堆叠和剪切。这必须在显示窗口容器之前完成。具有许多本机子窗口的应用程序可能会遇到性能问题。</font></p>
<p><font style="vertical-align: inherit;">窗口容器有许多已知的限制：</font></p>
<ul>
<li><font style="vertical-align: inherit;">堆叠顺序；嵌入的窗口将作为不透明框堆叠在组件层次结构的顶部。多个重叠窗口容器实例的堆叠顺序未定义。</font></li>
<li><font style="vertical-align: inherit;">渲染集成；窗口容器不与</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qgraphicsproxywidget.html"><font style="vertical-align: inherit;">QGraphicsProxyWidget</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#render"><font style="vertical-align: inherit;">QWidget::render</font></a><font style="vertical-align: inherit;"> () 或类似功能互操作。</font></li>
<li><font style="vertical-align: inherit;">焦点处理；可以让窗口容器实例具有任何焦点策略，它会通过调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html#requestActivate"><font style="vertical-align: inherit;">QWindow::requestActivate</font></a><font style="vertical-align: inherit;"> ()将焦点委托给窗口。然而，从</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html"><font style="vertical-align: inherit;">QWindow</font></a><font style="vertical-align: inherit;">实例返回到正常的焦点链将取决于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html"><font style="vertical-align: inherit;">QWindow</font></a><font style="vertical-align: inherit;">实例实现本身。例如，当进入一个带有标签焦点的基于 Qt Quick 的窗口时，很可能进一步按下标签只会在 QML 应用程序内循环。另外，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html#requestActivate"><font style="vertical-align: inherit;">QWindow::requestActivate</font></a><font style="vertical-align: inherit;"> ()是否真的给了窗口焦点，是平台相关的。</font></li>
<li><font style="vertical-align: inherit;">在基于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">的应用程序中使用许多窗口容器实例会极大地损害应用程序的整体性能。</font></li>
</ul>
<!-- @@@createWindowContainer -->
<!-- $$$customContextMenuRequested[overload1]$$$customContextMenuRequestedconstQPoint& -->
<h3 class="fn" id="customContextMenuRequested"><a name="customContextMenuRequested"></a><code>[signal] </code><span class="type">void</span> QWidget::<span class="name">customContextMenuRequested</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>pos</i>)</h3>
<p><font style="vertical-align: inherit;">当组件的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#contextMenuPolicy-prop"><font style="vertical-align: inherit;">contextMenuPolicy</font></a><font style="vertical-align: inherit;">为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ContextMenuPolicy-enum"><font style="vertical-align: inherit;">Qt::CustomContextMenu</font></a><font style="vertical-align: inherit;">并且用户已请求组件上的上下文菜单时，会发出此信号。位置</font><i><font style="vertical-align: inherit;">pos</font></i><font style="vertical-align: inherit;">是组件接收的上下文菜单事件的位置。通常这是在组件坐标中。此规则的例外是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qabstractscrollarea.html"><font style="vertical-align: inherit;">QAbstractScrollArea</font></a><font style="vertical-align: inherit;">及其子类，它们将上下文菜单事件映射到</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qabstractscrollarea.html#viewport"><font style="vertical-align: inherit;">viewport() 的</font></a><font style="vertical-align: inherit;">坐标。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mapToGlobal">mapToGlobal</a>(), <a href="qmenu.html">QMenu</a>,
<span lang="zh-cn">和</span><a href="qwidget.html#contextMenuPolicy-prop">contextMenuPolicy</a><span lang="zh-cn">。</span></p>
<!-- @@@customContextMenuRequested -->
<!-- $$$destroy[overload1]$$$destroyboolbool -->
<h3 class="fn" id="destroy"><a name="destroy"></a><code>[protected] </code><span class="type">void</span> QWidget::<span class="name">destroy</span>(<span class="type">bool</span> <i>destroyWindow</i> = true, <span class="type">bool</span> <i>destroySubWindows</i> = true)</h3>
<p><font style="vertical-align: inherit;">释放窗口系统资源。如果</font><i><font style="vertical-align: inherit;">destroyWindow</font></i><font style="vertical-align: inherit;">为真，则销毁组件窗口。</font></p>
<p><font style="vertical-align: inherit;">destroy() 为所有子组件递归调用自身，为<i>destroyWindow</i>参数传递</font><i><font style="vertical-align: inherit;">destroySubWindows</font></i><font style="vertical-align: inherit;">。为了更好地控制子组件的销毁，首先有选择地销毁子组件。</font></p>
<p><font style="vertical-align: inherit;">这个函数通常从</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">析构函数中调用。</font></p>
<!-- @@@destroy -->
<!-- $$$dragEnterEvent[overload1]$$$dragEnterEventQDragEnterEvent* -->
<h3 class="fn" id="dragEnterEvent"><a name="dragEnterEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">dragEnterEvent</span>(<span class="type"><a href="../qtgui/qdragenterevent.html">QDragEnterEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">当拖动正在进行并且鼠标进入此组件时，将调用此事件处理程序。事件在</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">event</span></font></i><font style="vertical-align: inherit;">参数中传递。</font></p>
<p><font style="vertical-align: inherit;">如果事件被忽略，组件将不会收到任何</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#dragMoveEvent"><font style="vertical-align: inherit;">拖动移动事件</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">有关如何在应用程序中提供拖放的概述，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/dnd.html"><font style="vertical-align: inherit;">拖放文档</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="../qtgui/qdrag.html">QDrag</a> <span lang="zh-cn">和 
</span><a href="../qtgui/qdragenterevent.html">QDragEnterEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@dragEnterEvent -->
<!-- $$$dragLeaveEvent[overload1]$$$dragLeaveEventQDragLeaveEvent* -->
<h3 class="fn" id="dragLeaveEvent"><a name="dragLeaveEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">dragLeaveEvent</span>(<span class="type"><a href="../qtgui/qdragleaveevent.html">QDragLeaveEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">当拖动正在进行并且鼠标离开此组件时，将调用此事件处理程序。事件在</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">event</span></font></i><font style="vertical-align: inherit;">参数中传递。</font></p>
<p><font style="vertical-align: inherit;">有关如何在应用程序中提供拖放的概述，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/dnd.html"><font style="vertical-align: inherit;">拖放文档</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="../qtgui/qdrag.html">QDrag</a> <span lang="zh-cn">和 
</span><a href="../qtgui/qdragleaveevent.html">QDragLeaveEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@dragLeaveEvent -->
<!-- $$$dragMoveEvent[overload1]$$$dragMoveEventQDragMoveEvent* -->
<h3 class="fn" id="dragMoveEvent"><a name="dragMoveEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">dragMoveEvent</span>(<span class="type"><a href="../qtgui/qdragmoveevent.html">QDragMoveEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">如果正在进行拖动，并且发生以下任何一种情况，则会调用此事件处理程序：光标进入此组件、光标在此组件内移动或在此组件具有焦点时按下键盘上的修饰键。事件在</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">event</span></font></i><font style="vertical-align: inherit;">参数中传递。</font></p>
<p><font style="vertical-align: inherit;">有关如何在应用程序中提供拖放的概述，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/dnd.html"><font style="vertical-align: inherit;">拖放文档</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="../qtgui/qdrag.html">QDrag</a> and <a href="../qtgui/qdragmoveevent.html">QDragMoveEvent</a>.</p>
<!-- @@@dragMoveEvent -->
<!-- $$$dropEvent[overload1]$$$dropEventQDropEvent* -->
<h3 class="fn" id="dropEvent"><a name="dropEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">dropEvent</span>(<span class="type"><a href="../qtgui/qdropevent.html">QDropEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">当拖放到此组件上时，将调用此事件处理程序。事件在</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">event</span></font></i><font style="vertical-align: inherit;">参数中传递。</font></p>
<p><font style="vertical-align: inherit;">有关如何在应用程序中提供拖放的概述，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/dnd.html"><font style="vertical-align: inherit;">拖放文档</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="../qtgui/qdrag.html">QDrag</a> <span lang="zh-cn">和 
</span><a href="../qtgui/qdropevent.html">QDropEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@dropEvent -->
<!-- $$$effectiveWinId[overload1]$$$effectiveWinId -->
<h3 class="fn" id="effectiveWinId"><a name="effectiveWinId"></a><span class="type">WId</span> QWidget::<span class="name">effectiveWinId</span>() const</h3>
<p><font style="vertical-align: inherit;">返回窗口组件的有效窗口系统标识符，即原生父窗口系统标识符。</font></p>
<p><font style="vertical-align: inherit;">如果组件是原生的，则此函数返回原生组件 ID。否则，返回第一个原生父窗口组件的窗口 ID，即包含此窗口组件的顶级窗口组件。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">我们建议您不要存储此值，因为它可能会在运行时更改。</font></p><p><font style="vertical-align: inherit;">这个函数是在 Qt 4.4 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#nativeParentWidget">nativeParentWidget</a>()<span lang="zh-cn">。</span></p>
<!-- @@@effectiveWinId -->
<!-- $$$ensurePolished[overload1]$$$ensurePolished -->
<h3 class="fn" id="ensurePolished"><a name="ensurePolished"></a><span class="type">void</span> QWidget::<span class="name">ensurePolished</span>() const</h3>
<p><font style="vertical-align: inherit;">确保组件及其子组件已由</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qstyle.html"><font style="vertical-align: inherit;">QStyle</font></a><font style="vertical-align: inherit;">修饰（即，具有适当的字体和调色板）。</font></p>
<p><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">在完全构造之后但在第一次显示之前调用此函数。如果您想确保在执行操作之前对组件进行抛光，则可以调用此函数，例如，在组件的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeHint-prop"><font style="vertical-align: inherit;">sizeHint</font></a><font style="vertical-align: inherit;"> () 重新实现中可能需要正确的字体大小。请注意，此函数</font><i><font style="vertical-align: inherit;">是</font></i><font style="vertical-align: inherit;">从</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeHint-prop"><font style="vertical-align: inherit;">sizeHint</font></a><font style="vertical-align: inherit;"> ()的默认实现中调用的。</font></p>
<p><font style="vertical-align: inherit;">抛光对于必须在调用所有构造函数（来自基类和子类）之后进行的最终初始化很有用。</font></p>
<p><font style="vertical-align: inherit;">如果在widget抛光时需要更改一些设置，重新实现</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#event"><font style="vertical-align: inherit;">event</font></a><font style="vertical-align: inherit;"> ()并处理</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::Polish</font></a><font style="vertical-align: inherit;">事件类型。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">该函数声明为const，以便可以从其他const 函数（例如</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeHint-prop"><font style="vertical-align: inherit;">sizeHint</font></a><font style="vertical-align: inherit;"> ()）中调用它。</font></p>
<p><b>请参考 </b><a href="qwidget.html#event">event</a>()<span lang="zh-cn">，</span></p>
<!-- @@@ensurePolished -->
<!-- $$$enterEvent[overload1]$$$enterEventQEvent* -->
<h3 class="fn" id="enterEvent"><a name="enterEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">enterEvent</span>(<span class="type"><a href="../qtcore/qevent.html">QEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现，以接收在</font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">参数中传递的组件输入事件。</font></p>
<p><font style="vertical-align: inherit;">当鼠标光标进入组件时，会向组件发送一个事件。</font></p>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#leaveEvent"><font style="vertical-align: inherit;">leaveEvent</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#mouseMoveEvent"><font style="vertical-align: inherit;">mouseMoveEvent</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#event"><font style="vertical-align: inherit;">event</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@enterEvent -->
<!-- $$$event[overload1]$$$eventQEvent* -->
<h3 class="fn" id="event"><code>[override virtual protected] </code><span class="type">bool</span> QWidget::<span class="name">event</span>(<span class="type"><a href="../qtcore/qevent.html">QEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">从</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qobject.html#event"><font style="vertical-align: inherit;">QObject::event</font></a><font style="vertical-align: inherit;"> ()重新实现。</font></p>
<p><font style="vertical-align: inherit;">这是主要的事件处理程序；它处理事件</font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">。您可以在子类中重新实现此函数，但我们建议改用其中一种专用事件处理程序。</font></p>
<p><font style="vertical-align: inherit;">按键按下和释放事件的处理方式与其他事件不同。event() 检查 Tab 和 Shift+Tab 并尝试适当移动焦点。如果没有要移动焦点的组件（或按键不是 Tab 或 Shift+Tab），则 event() 调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#keyPressEvent"><font style="vertical-align: inherit;">keyPressEvent</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><font style="vertical-align: inherit;">鼠标和平板电脑事件处理也有点特殊：只有在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#enabled-prop"><font style="vertical-align: inherit;">启用</font></a><font style="vertical-align: inherit;">组件时，event() 才会调用专门的处理程序，例如</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#mousePressEvent"><font style="vertical-align: inherit;">mousePressEvent</font></a><font style="vertical-align: inherit;"> ()；否则它将丢弃该事件。</font></p>
<p><font style="vertical-align: inherit;">如果事件被识别，<span lang="zh-cn">则返回<code>true，</code></span>否则返回</font><code>false</code><font style="vertical-align: inherit;">。如果识别的事件被接受（请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#accepted-prop"><font style="vertical-align: inherit;">QEvent::accepted</font></a><font style="vertical-align: inherit;">），则任何进一步的处理（例如事件传播到父组件）都会停止。</font></p>
<p><b>请参考 </b><a href="qwidget.html#closeEvent">closeEvent</a>(), <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#enterEvent">enterEvent</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>(), <a href="qwidget.html#leaveEvent">leaveEvent</a>(), <a href="qwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>(), <a href="qwidget.html#mousePressEvent">mousePressEvent</a>(), <a href="qwidget.html#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="qwidget.html#moveEvent">moveEvent</a>(), <a href="qwidget.html#paintEvent">paintEvent</a>(), <a href="qwidget.html#resizeEvent">resizeEvent</a>(), <a href="../qtcore/qobject.html#event">QObject::event</a>(),
<span lang="zh-cn">和 </span><a href="../qtcore/qobject.html#timerEvent">QObject::timerEvent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@event -->
<!-- $$$find[overload1]$$$findWId -->
<h3 class="fn" id="find"><a name="find"></a><code>[static] </code><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">find</span>(<span class="type">WId</span> <i>id</i>)</h3>
<p><span lang="zh-cn"><font style="vertical-align: inherit;">返回一个指向窗口标识符/句柄</font><i><font style="vertical-align: inherit;">id</font></i><font style="vertical-align: inherit;">的组件的指针。</font></span></p>
<p><font style="vertical-align: inherit;">窗口标识符类型取决于底层窗口系统，请参阅</font><code>qwindowdefs.h</code><font style="vertical-align: inherit;">实际定义。如果没有具有此标识符的组件，则返回 0。</font></p>
<!-- @@@find -->
<!-- $$$focusInEvent[overload1]$$$focusInEventQFocusEvent* -->
<h3 class="fn" id="focusInEvent"><a name="focusInEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">focusInEvent</span>(<span class="type"><a href="../qtgui/qfocusevent.html">QFocusEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现，以接收组件的键盘焦点事件（接收焦点）。事件在<i>event</i>参数中传递</font></p>
<p><font style="vertical-align: inherit;">组件通常必须将</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusPolicy-prop"><font style="vertical-align: inherit;">FocusPolicy</font></a><font style="vertical-align: inherit;"> () 设置为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#FocusPolicy-enum"><font style="vertical-align: inherit;">Qt::NoFocus 以外</font></a><font style="vertical-align: inherit;">的值才能接收焦点事件。（请注意，应用程序程序员可以对任何组件调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setFocus-1"><font style="vertical-align: inherit;">setFocus</font></a><font style="vertical-align: inherit;"> ()，即使是那些通常不接受焦点的组件。）</font></p>
<p><font style="vertical-align: inherit;">默认实现更新组件（不指定</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusPolicy-prop"><font style="vertical-align: inherit;">focusPolicy</font></a><font style="vertical-align: inherit;"> ()的窗口除外）。</font></p>
<p><b>请参考 </b><a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>(), <a href="qwidget.html#event">event</a>(),
<span lang="zh-cn">和 </span><a href="../qtgui/qfocusevent.html">QFocusEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@focusInEvent -->
<!-- $$$focusNextChild[overload1]$$$focusNextChild -->
<h3 class="fn" id="focusNextChild"><a name="focusNextChild"></a><code>[protected] </code><span class="type">bool</span> QWidget::<span class="name">focusNextChild</span>()</h3>
<p><font style="vertical-align: inherit;">查找一个新的组件以提供键盘焦点，适用于</font><b><font style="vertical-align: inherit;">Tab</font></b><span lang="zh-cn">键</span><font style="vertical-align: inherit;">，如果可以找到新的组件，则返回<code>true</code>，如果<span lang="zh-cn">找不到</span>，则返回false。</font></p>
<p><b>请参考 </b><a href="qwidget.html#focusPreviousChild">focusPreviousChild</a>()<span lang="zh-cn">。</span></p>
<!-- @@@focusNextChild -->
<!-- $$$focusNextPrevChild[overload1]$$$focusNextPrevChildbool -->
<h3 class="fn" id="focusNextPrevChild"><a name="focusNextPrevChild"></a><code>[virtual protected] </code><span class="type">bool</span> QWidget::<span class="name">focusNextPrevChild</span>(<span class="type">bool</span> <i>next</i>)</h3>
<p><font style="vertical-align: inherit;">根据 Tab 和 Shift+Tab 的需要，查找一个新的组件以将键盘焦点置于其上，</font><code>t</code><font style="vertical-align: inherit;">如果可以找到新的组件，则返回<code>rue</code>，如果不能找到，则返回false。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">next</font></i><font style="vertical-align: inherit;">为真，此函数向前搜索，如果</font><i><font style="vertical-align: inherit;">next</font></i><font style="vertical-align: inherit;">为假，则向后搜索。</font></p>
<p><font style="vertical-align: inherit;">有时，您会想要重新实现此功能。例如，Web 浏览器可能会重新实现它以向前或向后移动其“当前活动链接”，并且仅当它到达“页面”上的最后一个或第一个链接时才调用 focusNextPrevChild()。</font></p>
<p><font style="vertical-align: inherit;">子组件在其父组件上调用 focusNextPrevChild()，但只有包含子组件的窗口决定将焦点重定向到何处。通过为对象重新实现此函数，您可以控制所有子组件的焦点遍历。</font></p>
<p><b>请参考 </b><a href="qwidget.html#focusNextChild">focusNextChild</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#focusPreviousChild">focusPreviousChild</a>()<span lang="zh-cn">。</span></p>
<!-- @@@focusNextPrevChild -->
<!-- $$$focusOutEvent[overload1]$$$focusOutEventQFocusEvent* -->
<h3 class="fn" id="focusOutEvent"><a name="focusOutEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">focusOutEvent</span>(<span class="type"><a href="../qtgui/qfocusevent.html">QFocusEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现，以接收组件的键盘焦点事件（焦点丢失）。事件在<i>event</i>参数中传递。</font></p>
<p><font style="vertical-align: inherit;">组件通常必须将</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusPolicy-prop"><font style="vertical-align: inherit;">FocusPolicy</font></a><font style="vertical-align: inherit;"> () 设置为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#FocusPolicy-enum"><font style="vertical-align: inherit;">Qt::NoFocus 以外</font></a><font style="vertical-align: inherit;">的值才能接收焦点事件。（请注意，应用程序程序员可以对任何组件调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setFocus-1"><font style="vertical-align: inherit;">setFocus</font></a><font style="vertical-align: inherit;"> ()，即使是那些通常不接受焦点的组件。）</font></p>
<p><font style="vertical-align: inherit;">默认实现更新组件（不指定</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusPolicy-prop"><font style="vertical-align: inherit;">focusPolicy</font></a><font style="vertical-align: inherit;"> ()的窗口除外）。</font></p>
<p><b>请参考 </b><a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>(), <a href="qwidget.html#event">event</a>(),
<span lang="zh-cn">和</span><a href="../qtgui/qfocusevent.html">QFocusEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@focusOutEvent -->
<!-- $$$focusPreviousChild[overload1]$$$focusPreviousChild -->
<h3 class="fn" id="focusPreviousChild"><a name="focusPreviousChild"></a><code>[protected] </code><span class="type">bool</span> QWidget::<span class="name">focusPreviousChild</span>()</h3>
<p><font style="vertical-align: inherit;">查找一个新的组件以在键盘按下<b>Shift+Tab</b>时将焦点点置于合适的位置。</font><b><font style="vertical-align: inherit;"> </font></b><font style="vertical-align: inherit;">如果可以找到新的组件则返回<code>true</code>，如果不能则返回false。</font></p>
<p><b>请参考 </b><a href="qwidget.html#focusNextChild">focusNextChild</a>()<span lang="zh-cn">。</span></p>
<!-- @@@focusPreviousChild -->
<!-- $$$focusProxy[overload1]$$$focusProxy -->
<h3 class="fn" id="focusProxy"><a name="focusProxy"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">focusProxy</span>() const</h3>
<p><font style="vertical-align: inherit;">返回焦点代理，如果没有焦点代理，则返回 0。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setFocusProxy">setFocusProxy</a>()<span lang="zh-cn">。</span></p>
<!-- @@@focusProxy -->
<!-- $$$focusWidget[overload1]$$$focusWidget -->
<h3 class="fn" id="focusWidget"><a name="focusWidget"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">focusWidget</span>() const</h3>
<p><font style="vertical-align: inherit;">返回焦点代理，如果没有焦点代理，则返回 0。</font></p>
<p><font style="vertical-align: inherit;">这与</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qapplication.html#focusWidget"><font style="vertical-align: inherit;">QApplication::focusWidget</font></a><font style="vertical-align: inherit;"> () 不同，后者返回当前活动窗口中的焦点组件。</font></p>
<!-- @@@focusWidget -->
<!-- $$$fontInfo[overload1]$$$fontInfo -->
<h3 class="fn" id="fontInfo"><a name="fontInfo"></a><span class="type"><a href="../qtgui/qfontinfo.html">QFontInfo</a></span> QWidget::<span class="name">fontInfo</span>() const</h3>
<p><font style="vertical-align: inherit;">返回组件当前字体的字体信息。相当于</font><code>QFontInfo(widget-&gt;font())</code><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#font-prop">font</a>(), <a href="qwidget.html#fontMetrics">fontMetrics</a>(),
<span lang="zh-cn">和</span> <a href="qwidget.html#font-prop">setFont</a>()<span lang="zh-cn">。</span></p>
<!-- @@@fontInfo -->
<!-- $$$fontMetrics[overload1]$$$fontMetrics -->
<h3 class="fn" id="fontMetrics"><a name="fontMetrics"></a><span class="type"><a href="../qtgui/qfontmetrics.html">QFontMetrics</a></span> QWidget::<span class="name">fontMetrics</span>() const</h3>
<p><font style="vertical-align: inherit;">返回组件当前字体的字体规格。相当于</font><code>QFontMetrics(widget-&gt;font())</code><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#font-prop"><font style="vertical-align: inherit;">font</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#fontInfo"><font style="vertical-align: inherit;">fontInfo</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#font-prop"><font style="vertical-align: inherit;">setFont</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@fontMetrics -->
<!-- $$$foregroundRole[overload1]$$$foregroundRole -->
<h3 class="fn" id="foregroundRole"><a name="foregroundRole"></a><span class="type"><a href="../qtgui/qpalette.html#ColorRole-enum">QPalette::ColorRole</a></span> QWidget::<span class="name">foregroundRole</span>() const</h3>
<p><font style="vertical-align: inherit;">返回<span lang="zh-cn">前景</span>角色。</font></p>
<p><font style="vertical-align: inherit;">前景角色定义了用于绘制前景的组件</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#palette-prop"><font style="vertical-align: inherit;">调色板</font></a><font style="vertical-align: inherit;">的颜色。</font></p>
<p><font style="vertical-align: inherit;">如果未设置明确的前台角色，则该函数返回一个与后台角色形成对比的角色。</font></p>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setForegroundRole"><font style="vertical-align: inherit;">setForegroundRole</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#backgroundRole"><font style="vertical-align: inherit;">backgroundRole</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@foregroundRole -->
<!-- $$$getContentsMargins[overload1]$$$getContentsMarginsint*int*int*int* -->
<h3 class="fn" id="getContentsMargins"><a name="getContentsMargins"></a><span class="type">void</span> QWidget::<span class="name">getContentsMargins</span>(<span class="type">int</span> *<i>left</i>, <span class="type">int</span> *<i>top</i>, <span class="type">int</span> *<i>right</i>, <span class="type">int</span> *<i>bottom</i>) const</h3>
<p><font style="vertical-align: inherit;">返回组件的</font><i><font style="vertical-align: inherit;">left</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">top</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">right</font></i><font style="vertical-align: inherit;">和</font><i><font style="vertical-align: inherit;">bottom</font></i><font style="vertical-align: inherit;">内容边距。</font></p>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setContentsMargins"><font style="vertical-align: inherit;">setContentsMargins</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#contentsRect"><font style="vertical-align: inherit;">contentsRect</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@getContentsMargins -->
<!-- $$$grab[overload1]$$$grabconstQRect& -->
<h3 class="fn" id="grab"><a name="grab"></a><span class="type"><a href="../qtgui/qpixmap.html">QPixmap</a></span> QWidget::<span class="name">grab</span>(const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span> &amp;<i>rectangle</i> = QRect(QPoint(0, 0), QSize(-1, -1)))</h3>
<p><font style="vertical-align: inherit;">将组件<span lang="zh-cn">渲染</span>为受给定<i>rectangle</i>限制的像素图。如果组件有任何子组件，那么它们也会被绘制在适当的位置。</font></p>
<p><font style="vertical-align: inherit;">如果指定了一个无效大小的矩形（默认），则整个组件都会被绘制。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 5.0 中引入的。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">这个函数可以通过元对象系统和 QML 调用。见</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qobject.html#Q_INVOKABLE"><font style="vertical-align: inherit;">Q_INVOKABLE</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#render"><font style="vertical-align: inherit;">render</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpixmap.html"><font style="vertical-align: inherit;">QPixmap</font></a><font style="vertical-align: inherit;">。</font></p>
<!-- @@@grab -->
<!-- $$$grabGesture[overload1]$$$grabGestureQt::GestureTypeQt::GestureFlags -->
<h3 class="fn" id="grabGesture"><a name="grabGesture"></a><span class="type">void</span> QWidget::<span class="name">grabGesture</span>(<span class="type"><a href="../qtcore/qt.html#GestureType-enum">Qt::GestureType</a></span> <i>gesture</i>, <span class="type"><a href="../qtcore/qt.html#GestureFlag-enum">Qt::GestureFlags</a></span> <i>flags</i> = ...)</h3>
<p><font style="vertical-align: inherit;">将组件订阅到具有特定<i>标志<span lang="zh-cn">（flags）</span></i>的给定</font><i><font style="vertical-align: inherit;">手势</font></i><font style="vertical-align: inherit;"><span lang="zh-cn">（<i>gesture</i>）</span>。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.6 中引入的。</font></p>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#ungrabGesture"><font style="vertical-align: inherit;">ungrabGesture</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qgestureevent.html"><font style="vertical-align: inherit;">QGestureEvent</font></a><font style="vertical-align: inherit;">。</font></p>
<!-- @@@grabGesture -->
<!-- $$$grabKeyboard[overload1]$$$grabKeyboard -->
<h3 class="fn" id="grabKeyboard"><a name="grabKeyboard"></a><span class="type">void</span> QWidget::<span class="name">grabKeyboard</span>()</h3>
<p><font style="vertical-align: inherit;">抓取键盘输入。</font></p>
<p><font style="vertical-align: inherit;">此组件接收所有键盘事件，直到</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#releaseKeyboard"><font style="vertical-align: inherit;">调用 releaseKeyboard</font></a><font style="vertical-align: inherit;"> ()；其他组件<span lang="zh-cn">将不会收到</span>键盘事件<span lang="zh-cn">，</span>鼠标事件<span lang="zh-cn">也</span>不受影响。如果你想抓住它，请使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#grabMouse"><font style="vertical-align: inherit;">grabMouse</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><font style="vertical-align: inherit;">焦点组件不受影响，只是它不接收任何键盘事件。</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setFocus-1"><font style="vertical-align: inherit;">setFocus</font></a><font style="vertical-align: inherit;"> () 像往常一样移动焦点，但新的焦点组件只有在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#releaseKeyboard"><font style="vertical-align: inherit;">调用 releaseKeyboard</font></a><font style="vertical-align: inherit;"> ()后<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#releaseKeyboard">才会</a>接收键盘事件。</font></p>
<p><font style="vertical-align: inherit;">如果不同的组件当前正在抓取键盘输入，则首先释放该组件的抓取。</font></p>
<p><b>请参考 </b><a href="qwidget.html#releaseKeyboard">releaseKeyboard</a>(), <a href="qwidget.html#grabMouse">grabMouse</a>(), <a href="qwidget.html#releaseMouse">releaseMouse</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#focusWidget">focusWidget</a>()<span lang="zh-cn">。</span></p>
<!-- @@@grabKeyboard -->
<!-- $$$grabMouse[overload1]$$$grabMouse -->
<h3 class="fn" id="grabMouse"><a name="grabMouse"></a><span class="type">void</span> QWidget::<span class="name">grabMouse</span>()</h3>
<p><font style="vertical-align: inherit;">抓取鼠标输入。</font></p>
<p><font style="vertical-align: inherit;">此组件接收所有鼠标事件，直到</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#releaseMouse"><font style="vertical-align: inherit;">调用 releaseMouse</font></a><font style="vertical-align: inherit;"> ()；其他组件根本没有鼠标事件。键盘事件不受影响。如果你想抓住它，请使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#grabKeyboard"><font style="vertical-align: inherit;">grabKeyboard</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><b>Warning:</b> Bugs in mouse-grabbing applications very often lock the terminal. Use this function with extreme caution, and consider using the <code>-nograb</code> command line option while debugging.<b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;"><span lang="zh-cn">当使用</span>鼠标抓取<span lang="zh-cn">时，</span>应用程序<span lang="zh-cn">会有bug，它通常</span>会锁定终端。使用此功能要格外小心，<span lang="zh-cn">当调试时可以考虑使用，</span></font><code>-nograb</code><font style="vertical-align: inherit;">命令行选项。</font></p>
<p><font style="vertical-align: inherit;">使用 Qt 时几乎不需要抓住鼠标，因为 Qt 会明智地抓住和释放鼠标。特别是，当按下鼠标按钮时，Qt 会抓住鼠标并保持它直到释放最后一个按钮。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">只有可见的组件才能抓取鼠标输入。如果</font><span lang="zh-cn">调用</span><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">isVisible</font></a><font style="vertical-align: inherit;"> ()<span lang="zh-cn">返回</span></font><code>false</code><font style="vertical-align: inherit;">，则该组件无法调用grabMouse()。</font></p><p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">在 Windows 上，grabMouse() 仅在鼠标位于进程拥有的窗口内时才起作用。在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtdoc/internationalization.html#macos"><font style="vertical-align: inherit;">macOS 上</font></a><font style="vertical-align: inherit;">，grabMouse() 仅在鼠标位于该组件的框架内时才起作用。</font></p><p><b><font style="vertical-align: inherit;">
	参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#releaseMouse"><font style="vertical-align: inherit;">releaseMouse</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#grabKeyboard"><font style="vertical-align: inherit;">grabKeyboard</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#releaseKeyboard"><font style="vertical-align: inherit;">releaseKeyboard</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@grabMouse -->
<!-- $$$grabMouse$$$grabMouseconstQCursor& -->
<h3 class="fn" id="grabMouse-1"><a name="grabMouse-1"></a><span class="type">void</span> QWidget::<span class="name">grabMouse</span>(const <span class="type"><a href="../qtgui/qcursor.html">QCursor</a></span> &amp;<i>cursor</i>)</h3>
<p><font style="vertical-align: inherit;">该函数重载了</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#grabMouse"><font style="vertical-align: inherit;">grabMouse</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><font style="vertical-align: inherit;">抓取鼠标输入并更改光标形状。</font></p>
<p><font style="vertical-align: inherit;">光标将渲染</font><i><font style="vertical-align: inherit;">光标<span lang="zh-cn">（cursor）</span></font></i><font style="vertical-align: inherit;">形状（只要鼠标焦点被抓住）并且这个组件将是唯一一个接收鼠标事件的组件，直到</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#releaseMouse"><font style="vertical-align: inherit;">调用 releaseMouse</font></a><font style="vertical-align: inherit;"> ()()。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">抓住鼠标可能会锁定终端。</font></p>
<p><b><font style="vertical-align: inherit;">注：</font></b><font style="vertical-align: inherit;">见</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#grabMouse"><font style="vertical-align: inherit;">QWidget::grabMouse</font></a><font style="vertical-align: inherit;"> ()中的注解。</font></p><p><b>请参考 </b><a href="qwidget.html#releaseMouse">releaseMouse</a>(), <a href="qwidget.html#grabKeyboard">grabKeyboard</a>(), <a href="qwidget.html#releaseKeyboard">releaseKeyboard</a>(),
	<span lang="zh-cn">和 </span><a href="qwidget.html#cursor-prop">setCursor</a>()<span lang="zh-cn">。</span></p>
<!-- @@@grabMouse -->
<!-- $$$grabShortcut[overload1]$$$grabShortcutconstQKeySequence&Qt::ShortcutContext -->
<h3 class="fn" id="grabShortcut"><a name="grabShortcut"></a><span class="type">int</span> QWidget::<span class="name">grabShortcut</span>(const <span class="type"><a href="../qtgui/qkeysequence.html">QKeySequence</a></span> &amp;<i>key</i>, <span class="type"><a href="../qtcore/qt.html#ShortcutContext-enum">Qt::ShortcutContext</a></span> <i>context</i> = Qt::WindowShortcut)</h3>
<p><font style="vertical-align: inherit;">向 Qt 的快捷系统添加一个快捷方式，该系统在给定的<i>上下文</i>中监视给定的</font><i><font style="vertical-align: inherit;">键（key）</font></i><font style="vertical-align: inherit;">序列。如果<i>上下文</i>是<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ShortcutContext-enum">Qt::ApplicationShortcut</a>，则快捷方式适用于整个应用程序。否则，它要么是这个组件的本地<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ShortcutContext-enum">Qt::WidgetShortcut</a>，要么是窗口本身的<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#ShortcutContext-enum">Qt::WindowShortcut</a>。</font></p>
<p><font style="vertical-align: inherit;">如果相同的</font><i><font style="vertical-align: inherit;">按键</font></i><font style="vertical-align: inherit;">序列被多个组件抓取，当</font><i><font style="vertical-align: inherit;">按<span lang="zh-cn">键（key）</span></font></i><font style="vertical-align: inherit;">序列发生时，一个</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::Shortcut</font></a><font style="vertical-align: inherit;">事件会以不确定的顺序发送到所有应用它的组件，但设置了“模糊<span lang="zh-cn">（ambiguous）</span>”标志为真。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">您通常不需要使用此功能；而是使用您需要的快捷键序列创建</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qaction.html"><font style="vertical-align: inherit;">QAction</font></a><font style="vertical-align: inherit;">（如果您还需要等效的菜单选项和工具栏按钮），或者如果您只需要键序列，则创建</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qshortcut.html"><font style="vertical-align: inherit;">QShortcut</font></a><font style="vertical-align: inherit;"> 
。双方</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qaction.html"><font style="vertical-align: inherit;">的QAction</font></a><font style="vertical-align: inherit;">和</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qshortcut.html"><font style="vertical-align: inherit;">QShortcut</font></a><font style="vertical-align: inherit;">处理所有为你的事件过滤，并提供当用户触发键序列时触发信号，所以更容易比这个低层次的功能使用。</font></p>
<p><b>请参考 </b><a href="qwidget.html#releaseShortcut">releaseShortcut</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#setShortcutEnabled">setShortcutEnabled</a>()<span lang="zh-cn">。</span></p>
<!-- @@@grabShortcut -->
<!-- $$$graphicsEffect[overload1]$$$graphicsEffect -->
<h3 class="fn" id="graphicsEffect"><a name="graphicsEffect"></a><span class="type"><a href="qgraphicseffect.html">QGraphicsEffect</a></span> *QWidget::<span class="name">graphicsEffect</span>() const</h3>
<p><font style="vertical-align: inherit;">graphicsEffect 函数返回一个指向组件图形效果的指针。</font></p>
<p><font style="vertical-align: inherit;">如果组件没有图形效果，则返回 0。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.6 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setGraphicsEffect">setGraphicsEffect</a>()<span lang="zh-cn">。</span></p>
<!-- @@@graphicsEffect -->
<!-- $$$graphicsProxyWidget[overload1]$$$graphicsProxyWidget -->
<h3 class="fn" id="graphicsProxyWidget"><a name="graphicsProxyWidget"></a><span class="type"><a href="qgraphicsproxywidget.html">QGraphicsProxyWidget</a></span> *QWidget::<span class="name">graphicsProxyWidget</span>() const</h3>
<p><font style="vertical-align: inherit;">返回图形视图中相应嵌入组件的代理组件；否则返回</font><code>nullptr</code><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.5 中引入的。</font></p>
<p><b>请参考 </b><a href="qgraphicsproxywidget.html#createProxyForChildWidget">QGraphicsProxyWidget::createProxyForChildWidget</a>()
<span lang="zh-cn">和 </span><a href="qgraphicsscene.html#addWidget">QGraphicsScene::addWidget</a>()<span lang="zh-cn">。</span></p>
<!-- @@@graphicsProxyWidget -->
<!-- $$$hasEditFocus[overload1]$$$hasEditFocus -->
<h3 class="fn" id="hasEditFocus"><a name="hasEditFocus"></a><span class="type">bool</span> QWidget::<span class="name">hasEditFocus</span>() const</h3>
<p><font style="vertical-align: inherit;">此组件当前具有编辑焦点返回<code>true</code>；否则为<span lang="zh-cn">false</span>。</font></p>
<p><font style="vertical-align: inherit;">此功能仅在<span lang="zh-cn">嵌入式Linux Qt</span> 中可用。</font></p>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qgraphicsproxywidget.html#createProxyForChildWidget"><font style="vertical-align: inherit;">QGraphicsProxyWidget::createProxyForChildWidget</font></a><font style="vertical-align: inherit;"> () 和</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qgraphicsscene.html#addWidget"><font style="vertical-align: inherit;">QGraphicsScene::addWidget</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@hasEditFocus -->
<!-- $$$hasHeightForWidth[overload1]$$$hasHeightForWidth -->
<h3 class="fn" id="hasHeightForWidth"><a name="hasHeightForWidth"></a><code>[virtual] </code><span class="type">bool</span> QWidget::<span class="name">hasHeightForWidth</span>() const</h3>
<p><font style="vertical-align: inherit;"><span lang="zh-cn">如果</span>组件的首选高度取决于其宽度返回<code>true</code>；否则返回</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
	<font style="vertical-align: inherit;">这个函数是在 Qt 5.0 中引入的。</font><!-- @@@hasHeightForWidth --><!-- $$$heightForWidth[overload1]$$$heightForWidthint --><h3 class="fn" id="heightForWidth"><a name="heightForWidth"></a><code>[virtual] </code><span class="type">int</span> QWidget::<span class="name">heightForWidth</span>(<span class="type">int</span> <i>w</i>) const</h3>
<p><font style="vertical-align: inherit;"><span lang="zh-cn">通过</span>给定宽度</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">，返回此组件的首选高度。</font></p>
<p><font style="vertical-align: inherit;">如果此组件具有布局，则默认实现将返回布局的首选高度。如果没有布局，默认实现返回 -1 表示首选高度不依赖于宽度。</font></p>
<!-- @@@heightForWidth -->
<!-- $$$hide[overload1]$$$hide -->
<h3 class="fn" id="hide"><a name="hide"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">hide</span>()</h3>
<p><font style="vertical-align: inherit;">隐藏组件。此函数等效于</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">setVisible</font></a><font style="vertical-align: inherit;"> (false)。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">如果您正在使用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qdialog.html"><font style="vertical-align: inherit;">QDialog</font></a><font style="vertical-align: inherit;">或其子类，并且在此函数之后调用</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">show</font></a><font style="vertical-align: inherit;"> () 函数，则对话框将显示在其原始位置。</font></p><p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#hideEvent"><font style="vertical-align: inherit;">hideEvent</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isHidden"><font style="vertical-align: inherit;">isHidden</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">show</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">setVisible</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">isVisible</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#close"><font style="vertical-align: inherit;">close</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@hide -->
<!-- $$$hideEvent[overload1]$$$hideEventQHideEvent* -->
<h3 class="fn" id="hideEvent"><a name="hideEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">hideEvent</span>(<span class="type"><a href="../qtgui/qhideevent.html">QHideEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现以接收组件隐藏事件。事件在<i>event<span lang="zh-cn">
</span></i><span lang="zh-cn">参数</span>中传递。</font></p>
<p><font style="vertical-align: inherit;">隐藏事件在隐藏后立即发送到组件。</font></p>
<p><font style="vertical-align: inherit;">注意：当窗口系统改变其映射状态时，组件接收自发显示和隐藏事件，例如，当用户最小化窗口时自发隐藏事件，当窗口再次恢复时自发显示事件。在接收到自发隐藏事件后，widget 仍然被认为是</font><a href="file:///E:/_Personal/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">isVisible</font></a><font style="vertical-align: inherit;"> ()意义上的可见。</font></p>
<p><b>请参考 </b><a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#event">event</a>(),
<span lang="zh-cn">和</span> <a href="../qtgui/qhideevent.html">QHideEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@hideEvent -->
<!-- $$$initPainter[overload1]$$$initPainterQPainter* -->
<h3 class="fn" id="initPainter"><a name="initPainter"></a><code>[override virtual protected] </code><span class="type">void</span> QWidget::<span class="name">initPainter</span>(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span> *<i>painter</i>) const</h3>
<p><span lang="zh-cn">将<i>painter</i> （画家）的画笔、北京和字体初始化为和组件一样的值，<font style="vertical-align: inherit;">当在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">上开启画家时会自动调用此函数。</font></span></p>
<!-- @@@initPainter -->
<!-- $$$inputMethodEvent[overload1]$$$inputMethodEventQInputMethodEvent* -->
<h3 class="fn" id="inputMethodEvent"><a name="inputMethodEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">inputMethodEvent</span>(<span class="type"><a href="../qtgui/qinputmethodevent.html">QInputMethodEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于<span lang="zh-cn">处理输入法组合</span>事件</font><i><font style="vertical-align: inherit;">event</font></i><span lang="zh-cn">。</span><font style="vertical-align: inherit;">可以在子类中重新实现<span lang="zh-cn">该事件</span>，<span lang="zh-cn">以自定义处理</span>输入法组合事件。当输入法的状态改变时调用这个处理程序。</font></p>
<p><font style="vertical-align: inherit;">请注意，在创建自定义文本编辑组件时，必须显式设置</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum"><font style="vertical-align: inherit;">Qt::WA_InputMethodEnabled</font></a><font style="vertical-align: inherit;">窗口属性（使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setAttribute"><font style="vertical-align: inherit;">setAttribute</font></a><font style="vertical-align: inherit;"> () 函数）以便接收输入法事件。</font></p>
<p><font style="vertical-align: inherit;">默认实现调用 event-&gt;ignore()，它拒绝输入法事件。有关更多详细信息，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qinputmethodevent.html"><font style="vertical-align: inherit;">QInputMethodEvent</font></a><font style="vertical-align: inherit;">文档。</font></p>
<p><b>请参考 </b><a href="qwidget.html#event">event</a>() <span lang="zh-cn">和 
</span><a href="../qtgui/qinputmethodevent.html">QInputMethodEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@inputMethodEvent -->
<!-- $$$inputMethodQuery[overload1]$$$inputMethodQueryQt::InputMethodQuery -->
<h3 class="fn" id="inputMethodQuery"><a name="inputMethodQuery"></a><code>[virtual] </code><span class="type"><a href="../qtcore/qvariant.html">QVariant</a></span> QWidget::<span class="name">inputMethodQuery</span>(<span class="type"><a href="../qtcore/qt.html#InputMethodQuery-enum">Qt::InputMethodQuery</a></span> <i>query</i>) const</h3>
<p><font style="vertical-align: inherit;">此方法仅与输入组件相关。输入法使用它来查询组件的一组属性，以便能够支持复杂的输入法操作，如支持周围文本和重新转换。</font></p>
<p><i><font style="vertical-align: inherit;">query</font></i><font style="vertical-align: inherit;">指定要查询的属性。</font></p>
<p><b>请参考 </b><a href="qwidget.html#inputMethodEvent">inputMethodEvent</a>(), <a href="../qtgui/qinputmethodevent.html">QInputMethodEvent</a>, <a href="../qtgui/qinputmethodqueryevent.html">QInputMethodQueryEvent</a>,
<span lang="zh-cn">和</span><a href="qwidget.html#inputMethodHints-prop">inputMethodHints</a><span lang="zh-cn">。</span></p>
<!-- @@@inputMethodQuery -->
<!-- $$$insertAction[overload1]$$$insertActionQAction*QAction* -->
<h3 class="fn" id="insertAction"><a name="insertAction"></a><span class="type">void</span> QWidget::<span class="name">insertAction</span>(<span class="type"><a href="qaction.html">QAction</a></span> *<i>before</i>, <span class="type"><a href="qaction.html">QAction</a></span> *<i>action</i>)</h3>
<p><font style="vertical-align: inherit;">将动作</font><i><font style="vertical-align: inherit;">action</font></i><font style="vertical-align: inherit;"><span lang="zh-cn">（动作）</span>插入到此组件的动作列表中，在动作</font><i><font style="vertical-align: inherit;">之前</font></i><font style="vertical-align: inherit;">。如果</font><i><font style="vertical-align: inherit;">before</font></i><font style="vertical-align: inherit;">为 0 或</font><i><font style="vertical-align: inherit;">before</font></i><font style="vertical-align: inherit;">不是此组件的有效<span lang="zh-cn">动作</span>，它会附加<span lang="zh-cn">上这个动作</span>。</font></p>
<p><font style="vertical-align: inherit;">一个</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget的</font></a><font style="vertical-align: inherit;">应该只有每个动作<span lang="zh-cn">的唯一实例</span>。</font></p>
<p><b>请参考 </b><a href="qwidget.html#removeAction">removeAction</a>(), <a href="qwidget.html#addAction">addAction</a>(), <a href="qmenu.html">QMenu</a>, <a href="qwidget.html#contextMenuPolicy-prop">contextMenuPolicy</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#actions">actions</a>()<span lang="zh-cn">。</span></p>
<!-- @@@insertAction -->
<!-- $$$insertActions[overload1]$$$insertActionsQAction*QList<QAction*> -->
<h3 class="fn" id="insertActions"><a name="insertActions"></a><span class="type">void</span> QWidget::<span class="name">insertActions</span>(<span class="type"><a href="qaction.html">QAction</a></span> *<i>before</i>, <span class="type"><a href="../qtcore/qlist.html">QList</a></span>&lt;<span class="type"><a href="qaction.html">QAction</a></span> *&gt; <i>actions</i>)</h3>
<p><font style="vertical-align: inherit;">在动作<i><span lang="zh-cn">before</span>前<span lang="zh-cn">，</span></i>将<span lang="zh-cn">一组</span>动作<i>actions</i> 插入到此组件的动作列表中。如果</font><i><font style="vertical-align: inherit;">before</font></i><font style="vertical-align: inherit;">为 0 或</font><i><font style="vertical-align: inherit;">before</font></i><font style="vertical-align: inherit;">不是此组件的有效操作，它会附加操作。</font></p>
<p><font style="vertical-align: inherit;">一个</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget的</font></a><font style="vertical-align: inherit;">应该只有每个动作<span lang="zh-cn">的唯一实例</span>。</font></p>
<p><b>请参考 </b><a href="qwidget.html#removeAction">removeAction</a>(), <a href="qmenu.html">QMenu</a>, <a href="qwidget.html#insertAction">insertAction</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#contextMenuPolicy-prop">contextMenuPolicy</a><span lang="zh-cn">。</span></p>
<!-- @@@insertActions -->
<!-- $$$isAncestorOf[overload1]$$$isAncestorOfconstQWidget* -->
<h3 class="fn" id="isAncestorOf"><a name="isAncestorOf"></a><span class="type">bool</span> QWidget::<span class="name">isAncestorOf</span>(const <span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>child</i>) const</h3>
<p><span lang="zh-cn">如果组件是一个祖先级组件（父级或比父级更高的级别）并且他们同在一个窗口中则返回<code>true，否则返回false</code>。</span></p>
<!-- @@@isAncestorOf -->
<!-- $$$isEnabledTo[overload1]$$$isEnabledToconstQWidget* -->
<h3 class="fn" id="isEnabledTo"><a name="isEnabledTo"></a><span class="type">bool</span> QWidget::<span class="name">isEnabledTo</span>(const <span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>ancestor</i>) const</h3>
<p><span lang="zh-cn">如果该组件在祖先组件<i>ancestor</i>中是可用的则返回<code>true</code> ，否则返回<code>false</code>。</span></p>
<p><font style="vertical-align: inherit;">如果组件本身和直到但不包括</font><i><font style="vertical-align: inherit;">ancestor<span lang="zh-cn">（</span>祖先<span lang="zh-cn">）</span>的</font></i><font style="vertical-align: inherit;">每个级<span lang="zh-cn">别</span>都没有被明确禁用，就会出现这种情况。</font></p>
<p><font style="vertical-align: inherit;">如果此组件或其祖先被明确禁用，则 isEnabledTo(0) 将返回 
<span lang="zh-cn"> <code>false</code></span>。</font></p>
<p><font style="vertical-align: inherit;">这里的祖先这个词是指同一窗口内的父组件。</font></p>
<p><font style="vertical-align: inherit;">因此<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#enabled-prop">isEnabled</a>(0)会在这个组件的窗口停止，不像isEnabled()也会考虑父窗口。</font></p>
<p><b>请参考 </b><a href="qwidget.html#enabled-prop">setEnabled</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#enabled-prop">enabled</a><span lang="zh-cn">。</span></p>
<!-- @@@isEnabledTo -->
<!-- $$$isHidden[overload1]$$$isHidden -->
<h3 class="fn" id="isHidden"><a name="isHidden"></a><span class="type">bool</span> QWidget::<span class="name">isHidden</span>() const</h3>
<p><font style="vertical-align: inherit;">如果组件是隐藏的返回<code>true</code>，否则返回</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">隐藏的组件只有在调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">show</font></a><font style="vertical-align: inherit;"> ()时才会变得可见。显示父项时不会自动显示。</font></p>
<p><font style="vertical-align: inherit;">要检查可见性，请使用 ! </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">isVisible</font></a><font style="vertical-align: inherit;"> () 代替（注意感叹号）。</font></p>
<p style="width: 70%">isHidden()意味着!<a href="qwidget.html#visible-prop">isVisible</a>()，但是组件可以同时不可见和不隐藏。这种情况适用于不可见组件的子组件。</p>
<p><font style="vertical-align: inherit;">如果出现以下情况，组件将被隐藏：</font></p>
<ul>
<li><font style="vertical-align: inherit;">它们被创建为独立的窗口，</font></li>
<li><font style="vertical-align: inherit;">它们是作为可见组件的子级创建的，</font></li>
<li><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#hide"><font style="vertical-align: inherit;">hide</font></a><font style="vertical-align: inherit;"> () 或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">setVisible</font></a><font style="vertical-align: inherit;"> (false) 被调用。</font></li>
</ul>
<!-- @@@isHidden -->
<!-- $$$isVisibleTo[overload1]$$$isVisibleToconstQWidget* -->
<h3 class="fn" id="isVisibleTo"><a name="isVisibleTo"></a><span class="type">bool</span> QWidget::<span class="name">isVisibleTo</span>(const <span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>ancestor</i>) const</h3>
<p><span lang="zh-cn">如果<i>ancestor</i> （祖先）被显示，则该组件也将是可见的，此时返回<code>true</code> 
，否则返回<code>false。</code></span></p>
<p>如果组件本身和任何<span lang="zh-cn">上级</span>组件(不包括<i>ancestor</i>组件)都没有显式<span lang="zh-cn">地</span>隐藏，则会出现<span lang="zh-cn"><code>true</code> 
</span>的情况。</p>
<p><font style="vertical-align: inherit;">如果组件被屏幕上的其他窗口遮挡，则此函数仍将返回 
true，但如果要移动它或它们，则可能在物理上可见。</font></p>
<p><font style="vertical-align: inherit;">isVisibleTo(0) 与</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">isVisible</font></a><font style="vertical-align: inherit;"> ()相同。</font></p>
<p><b>请参考 </b><a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#visible-prop">isVisible</a>()<span lang="zh-cn">。</span></p>
<!-- @@@isVisibleTo -->
<!-- $$$isWindow[overload1]$$$isWindow -->
<h3 class="fn" id="isWindow"><a name="isWindow"></a><span class="type">bool</span> QWidget::<span class="name">isWindow</span>() const</h3>
<p><font style="vertical-align: inherit;">如果组件是一个独立的窗口返回<code>true</code>，否则返回</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">窗口是一个组件，它在视觉上不是任何其他组件的子组件，通常有一个框架和一个</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#windowTitle-prop"><font style="vertical-align: inherit;">窗口标题</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">一个窗口可以有一个</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#parentWidget"><font style="vertical-align: inherit;">父组件</font></a><font style="vertical-align: inherit;">。然后，它将与其父对象分组，并在删除父对象时将其删除，在最小化父对象时将其最小化等。如果窗口管理器支持，它还将具有与其父对象相同的任务栏条目。</font></p>
<p><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qdialog.html"><font style="vertical-align: inherit;">QDialog</font></a><font style="vertical-align: inherit;">和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qmainwindow.html"><font style="vertical-align: inherit;">QMainWindow</font></a><font style="vertical-align: inherit;">组件默认是窗口，即使在构造函数中指定了父组件。此行为由</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::Window</font></a><font style="vertical-align: inherit;">标志指定。</font></p>
<p><b>请参考 </b><a href="qwidget.html#window">window</a>(), <a href="qwidget.html#modal-prop">isModal</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#parentWidget">parentWidget</a>()<span lang="zh-cn">。</span></p>
<!-- @@@isWindow -->
<!-- $$$keyPressEvent[overload1]$$$keyPressEventQKeyEvent* -->
<h3 class="fn" id="keyPressEvent"><a name="keyPressEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">keyPressEvent</span>(<span class="type"><a href="../qtgui/qkeyevent.html">QKeyEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于<span lang="zh-cn">键盘事件</span></font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现<span lang="zh-cn">它</span>，以<span lang="zh-cn">自定义处理</span>组件的<span lang="zh-cn">键盘</span>事件。</font></p>
<p><font style="vertical-align: inherit;">组件必须首先调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusPolicy-prop"><font style="vertical-align: inherit;">setFocusPolicy</font></a><font style="vertical-align: inherit;"> () 来接受焦点并获得焦点才能接收<span lang="zh-cn">键盘</span>事件。</font></p>
<p><font style="vertical-align: inherit;">如果你重新实现这个处理程序，如果你没有对<span lang="zh-cn">按</span>键进行<span lang="zh-cn">什么实际处理</span>，那么调用基类实现是非常重要的。</font></p>
<p><font style="vertical-align: inherit;">如果用户按下</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qkeysequence.html#StandardKey-enum"><font style="vertical-align: inherit;">QKeySequence::Cancel</font></a><font style="vertical-align: inherit;">的按键序列（通常是 Escape 键），则默认实现将关闭弹出窗口组件。否则该事件将被忽略，以便组件的父级可以解释它。</font></p>
<p><font style="vertical-align: inherit;">请注意，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qkeyevent.html"><font style="vertical-align: inherit;">QKeyEvent</font></a><font style="vertical-align: inherit;">以 
isAccepted() <span lang="zh-cn">传进来时就是</span> true ，因此您不需要调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#accept"><font style="vertical-align: inherit;">QKeyEvent::accept</font></a><font style="vertical-align: inherit;"> () - 如果您对按键进行了处理，则不要调用基类实现。</font></p>
<p><b>请参考 </b><a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>(), <a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>(), <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#event">event</a>(), <a href="../qtgui/qkeyevent.html">QKeyEvent</a>,
<span lang="zh-cn">和 </span><a href="qtwidgets-widgets-tetrix-example.html">Tetrix Example</a><span lang="zh-cn">。</span></p>
<!-- @@@keyPressEvent -->
<!-- $$$keyReleaseEvent[overload1]$$$keyReleaseEventQKeyEvent* -->
<h3 class="fn" id="keyReleaseEvent"><a name="keyReleaseEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">keyReleaseEvent</span>(<span class="type"><a href="../qtgui/qkeyevent.html">QKeyEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于<span lang="zh-cn">键盘释放事件</span></font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现，以<span lang="zh-cn">自定义</span>组件的<span lang="zh-cn">键盘</span>释放事件。</font></p>
<p><font style="vertical-align: inherit;">组件必须最初</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusPolicy-prop"><font style="vertical-align: inherit;">接受焦点</font></a><font style="vertical-align: inherit;">并</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focus-prop"><font style="vertical-align: inherit;">获得焦点</font></a><font style="vertical-align: inherit;">才能接收按键释放事件。</font></p>
<p><font style="vertical-align: inherit;">如果你重新实现这个处理程序，如果你没有<span lang="zh-cn">处理该事件</span>，那么调用基类实现是非常重要的。</font></p>
<p><font style="vertical-align: inherit;">默认实现忽略该事件，以便组件的父级可以解释它。</font></p>
<p><font style="vertical-align: inherit;">请注意，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qkeyevent.html"><font style="vertical-align: inherit;">QKeyEvent</font></a><font style="vertical-align: inherit;">以 
isAccepted() <span lang="zh-cn">传进来时就是</span> true ，因此您不需要调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#accept"><font style="vertical-align: inherit;">QKeyEvent::accept</font></a><font style="vertical-align: inherit;"> () - 如果您对按键进行了处理，则不要调用基类实现。</font></p>
<p><b>请参考 </b><a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="../qtcore/qevent.html#ignore">QEvent::ignore</a>(), <a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>(), <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#event">event</a>(),
<span lang="zh-cn">和 </span><a href="../qtgui/qkeyevent.html">QKeyEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@keyReleaseEvent -->
<!-- $$$keyboardGrabber[overload1]$$$keyboardGrabber -->
<h3 class="fn" id="keyboardGrabber"><a name="keyboardGrabber"></a><code>[static] </code><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">keyboardGrabber</span>()</h3>
<p><font style="vertical-align: inherit;">返回当前正在<span lang="zh-cn">抓取</span>键盘输入的组件。</font></p>
<p><font style="vertical-align: inherit;">如果此应用程序中没有组件当前正在抓取键盘，则返回 0。</font></p>
<p><b>请参考 </b><a href="qwidget.html#grabMouse">grabMouse</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#mouseGrabber">mouseGrabber</a>()<span lang="zh-cn">。</span></p>
<!-- @@@keyboardGrabber -->
<!-- $$$layout[overload1]$$$layout -->
<h3 class="fn" id="layout"><a name="layout"></a><span class="type"><a href="qlayout.html">QLayout</a></span> *QWidget::<span class="name">layout</span>() const</h3>
<p><font style="vertical-align: inherit;">回安装在此组件上的布局管理器，如果未安装布局管理器，则返回 0。</font></p>
<p><font style="vertical-align: inherit;">布局管理器设置已添加到组件<span lang="zh-cn">的</span>布局中的<span lang="zh-cn">子组件</span>的几何形状。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setLayout">setLayout</a>(), <a href="qwidget.html#sizePolicy-prop">sizePolicy</a>(),
<span lang="zh-cn">和 </span><a href="layout.html">Layout Management</a><span lang="zh-cn">。</span></p>
<!-- @@@layout -->
<!-- $$$leaveEvent[overload1]$$$leaveEventQEvent* -->
<h3 class="fn" id="leaveEvent"><a name="leaveEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">leaveEvent</span>(<span class="type"><a href="../qtcore/qevent.html">QEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现，以<span lang="zh-cn">处理</span>在</font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">参数中传递的组件离开事件。</font></p>
<p><font style="vertical-align: inherit;">当鼠标光标离开组件时，会向组件发送离开事件。</font></p>
<p><b>请参考 </b><a href="qwidget.html#enterEvent">enterEvent</a>(), <a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#event">event</a>()<span lang="zh-cn">。</span></p>
<!-- @@@leaveEvent -->
<!-- $$$lower[overload1]$$$lower -->
<h3 class="fn" id="lower"><a name="lower"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">lower</span>()</h3>
<p><font style="vertical-align: inherit;">组件降低到父组件堆栈的底部。</font></p>
	<p>&nbsp;</p>
<p><font style="vertical-align: inherit;">在此调用之后，组件将在视觉上<span lang="zh-cn">低于</span>于（因此被遮挡）任何重叠的同级组件。</font></p>
<p><b>请参考 </b><a href="qwidget.html#raise">raise</a>() <span lang="zh-cn">和 
</span><a href="qwidget.html#stackUnder">stackUnder</a>()<span lang="zh-cn">。</span></p>
<!-- @@@lower -->
<!-- $$$mapFrom[overload1]$$$mapFromconstQWidget*constQPoint& -->
<h3 class="fn" id="mapFrom"><a name="mapFrom"></a><span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> QWidget::<span class="name">mapFrom</span>(const <span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>parent</i>, const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>pos</i>) const</h3>
<p><font style="vertical-align: inherit;">将组件坐标位置</font><i><font style="vertical-align: inherit;">pos</font></i><font style="vertical-align: inherit;">从</font><i><font style="vertical-align: inherit;">parent（父级</font></i><font style="vertical-align: inherit;">）坐标系转换为该组件的坐标系。</font><i><font style="vertical-align: inherit;">parent（父级</font></i><font style="vertical-align: inherit;">）不能为0，且必须是调用组件的父组件。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mapTo">mapTo</a>(), <a href="qwidget.html#mapFromParent">mapFromParent</a>(), <a href="qwidget.html#mapFromGlobal">mapFromGlobal</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#underMouse">underMouse</a>()<span lang="zh-cn">。</span></p>
<!-- @@@mapFrom -->
<!-- $$$mapFromGlobal[overload1]$$$mapFromGlobalconstQPoint& -->
<h3 class="fn" id="mapFromGlobal"><a name="mapFromGlobal"></a><span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> QWidget::<span class="name">mapFromGlobal</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>pos</i>) const</h3>
<p><font style="vertical-align: inherit;">将全局屏幕坐标</font><i><font style="vertical-align: inherit;">pos 转换</font></i><font style="vertical-align: inherit;">为组件坐标。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mapToGlobal">mapToGlobal</a>(), <a href="qwidget.html#mapFrom">mapFrom</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#mapFromParent">mapFromParent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@mapFromGlobal -->
<!-- $$$mapFromParent[overload1]$$$mapFromParentconstQPoint& -->
<h3 class="fn" id="mapFromParent"><a name="mapFromParent"></a><span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> QWidget::<span class="name">mapFromParent</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>pos</i>) const</h3>
<p><font style="vertical-align: inherit;">将父组件坐标</font><i><font style="vertical-align: inherit;">pos 转换</font></i><font style="vertical-align: inherit;">为组件坐标。</font></p>
<p><font style="vertical-align: inherit;">如果组件没有父级，则与</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#mapFromGlobal"><font style="vertical-align: inherit;">mapFromGlobal</font></a><font style="vertical-align: inherit;"> ()相同。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mapToParent">mapToParent</a>(), <a href="qwidget.html#mapFrom">mapFrom</a>(), <a href="qwidget.html#mapFromGlobal">mapFromGlobal</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#underMouse">underMouse</a>()<span lang="zh-cn">。</span></p>
<!-- @@@mapFromParent -->
<!-- $$$mapTo[overload1]$$$mapToconstQWidget*constQPoint& -->
<h3 class="fn" id="mapTo"><a name="mapTo"></a><span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> QWidget::<span class="name">mapTo</span>(const <span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>parent</i>, const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>pos</i>) const</h3>
<p><font style="vertical-align: inherit;">将组件坐标</font><i><font style="vertical-align: inherit;">pos</font></i><font style="vertical-align: inherit;">转换为</font><i><font style="vertical-align: inherit;">parent</font></i><font style="vertical-align: inherit;">的坐标系。在<i>parent</i>不能为0，且必须调用<span lang="zh-cn">组件</span>的<span lang="zh-cn">父组件</span>。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mapFrom">mapFrom</a>(), <a href="qwidget.html#mapToParent">mapToParent</a>(), <a href="qwidget.html#mapToGlobal">mapToGlobal</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#underMouse">underMouse</a>()<span lang="zh-cn">。</span></p>
<!-- @@@mapTo -->
<!-- $$$mapToGlobal[overload1]$$$mapToGlobalconstQPoint& -->
<h3 class="fn" id="mapToGlobal"><a name="mapToGlobal"></a><span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> QWidget::<span class="name">mapToGlobal</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>pos</i>) const</h3>
<p><font style="vertical-align: inherit;">将组件坐标</font><i><font style="vertical-align: inherit;">pos 转换</font></i><font style="vertical-align: inherit;">为全局屏幕坐标。例如，</font><code>mapToGlobal(QPoint(0,0))</code><font style="vertical-align: inherit;">将给出组件左上角像素的全局坐标。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mapFromGlobal">mapFromGlobal</a>(), <a href="qwidget.html#mapTo">mapTo</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#mapToParent">mapToParent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@mapToGlobal -->
<!-- $$$mapToParent[overload1]$$$mapToParentconstQPoint& -->
<h3 class="fn" id="mapToParent"><a name="mapToParent"></a><span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> QWidget::<span class="name">mapToParent</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>pos</i>) const</h3>
<p><font style="vertical-align: inherit;">将组件坐标</font><i><font style="vertical-align: inherit;">pos</font></i><font style="vertical-align: inherit;">转换为父组件中的坐标。</font></p>
<p><font style="vertical-align: inherit;">如果组件没有父级，则与</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#mapToGlobal"><font style="vertical-align: inherit;">mapToGlobal</font></a><font style="vertical-align: inherit;"> ()相同。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mapFromParent">mapFromParent</a>(), <a href="qwidget.html#mapTo">mapTo</a>(), <a href="qwidget.html#mapToGlobal">mapToGlobal</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#underMouse">underMouse</a>()<span lang="zh-cn">。</span></p>
<!-- @@@mapToParent -->
<!-- $$$mask[overload1]$$$mask -->
<h3 class="fn" id="mask"><a name="mask"></a><span class="type"><a href="../qtgui/qregion.html">QRegion</a></span> QWidget::<span class="name">mask</span>() const</h3>
<p>Returns the mask currently set on a widget. If no mask is set the return value will be an empty region.</p>
<p><b>请参考 </b><a href="qwidget.html#setMask">setMask</a>(), <a href="qwidget.html#clearMask">clearMask</a>(), <a href="../qtgui/qregion.html#isEmpty">QRegion::isEmpty</a>(),
<span lang="zh-cn">和 </span>
<a href="qtwidgets-widgets-shapedclock-example.html">Shaped Clock
<span lang="zh-cn">示例</span></a><span lang="zh-cn">。</span></p>
<!-- @@@mask -->
<!-- $$$metric[overload1]$$$metricQPaintDevice::PaintDeviceMetric -->
<h3 class="fn" id="metric"><a name="metric"></a><code>[override virtual protected] </code><span class="type">int</span> QWidget::<span class="name">metric</span>(<span class="type"><a href="../qtgui/qpaintdevice.html#PaintDeviceMetric-enum">QPaintDevice::PaintDeviceMetric</a></span> <i>m</i>) const</h3>
<p><font style="vertical-align: inherit;">从</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpaintdevice.html#metric"><font style="vertical-align: inherit;">QPaintDevice::metric</font></a><font style="vertical-align: inherit;"> ()重新实现。</font></p>
<p><font style="vertical-align: inherit;">虚</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpaintdevice.html#metric"><font style="vertical-align: inherit;">QPaintDevice::metric</font></a><font style="vertical-align: inherit;"> () 函数的内部实现。</font></p>
<p><i><font style="vertical-align: inherit;">m</font></i><font style="vertical-align: inherit;">是要获得的<span lang="zh-cn">度量</span>。</font></p>
<!-- @@@metric -->
<!-- $$$mouseDoubleClickEvent[overload1]$$$mouseDoubleClickEventQMouseEvent* -->
<h3 class="fn" id="mouseDoubleClickEvent"><a name="mouseDoubleClickEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">mouseDoubleClickEvent</span>(<span class="type"><a href="../qtgui/qmouseevent.html">QMouseEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于处理鼠标双击事件 </font><i>
<font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现，以自定义处理组件的鼠标双击事件。</font></p>
<p><font style="vertical-align: inherit;">默认实现调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#mousePressEvent"><font style="vertical-align: inherit;">mousePressEvent</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">除了双击事件之外，组件还将接收鼠标按下和鼠标释放事件。开发人员有责任确保应用程序正确解释这些事件。</font></p><p><b>请参考 </b><a href="qwidget.html#mousePressEvent">mousePressEvent</a>(), <a href="qwidget.html#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>(), <a href="qwidget.html#event">event</a>(),
	<span lang="zh-cn">和 </span><a href="../qtgui/qmouseevent.html">QMouseEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@mouseDoubleClickEvent -->
<!-- $$$mouseGrabber[overload1]$$$mouseGrabber -->
<h3 class="fn" id="mouseGrabber"><a name="mouseGrabber"></a><code>[static] </code><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">mouseGrabber</span>()</h3>
<p><font style="vertical-align: inherit;">返回当前正在抓取鼠标输入的组件。</font></p>
<p><font style="vertical-align: inherit;">如果此应用程序中当前没有正在抓取鼠标<span lang="zh-cn">的</span>组件，则返回 0。</font></p>
<p><b>请参考 </b><a href="qwidget.html#grabMouse">grabMouse</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#keyboardGrabber">keyboardGrabber</a>()<span lang="zh-cn">。</span></p>
<!-- @@@mouseGrabber -->
<!-- $$$mouseMoveEvent[overload1]$$$mouseMoveEventQMouseEvent* -->
<h3 class="fn" id="mouseMoveEvent"><a name="mouseMoveEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">mouseMoveEvent</span>(<span class="type"><a href="../qtgui/qmouseevent.html">QMouseEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于<span lang="zh-cn">鼠标移动事件</span></font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现，以<span lang="zh-cn">自定义处理</span>组件的鼠标移动事件。</font></p>
<p><font style="vertical-align: inherit;">如果关闭鼠标跟踪，则只有在移动鼠标时按下鼠标按钮才会发生鼠标移动事件。如果打开鼠标跟踪，即使没有按下鼠标按钮，也会发生鼠标移动事件。</font></p>
<p><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qmouseevent.html#pos"><font style="vertical-align: inherit;">QMouseEvent::pos</font></a><font style="vertical-align: inherit;"> 
() 报告鼠标光标相对于这个组件的位置。对于按下和释放事件，位置通常与上次鼠标移动事件的位置相同，但如果用户的手抖动，则位置可能不同。这是底层窗口系统的一个特性，而不是 Qt的特性。</font></p>
<p>如果您想在鼠标移动时立即显示工具提示(例如，使用<a href="../qtgui/qmouseevent.html#pos">QMouseEvent::pos</a>()获取鼠标坐标并将其显示为工具提示)，您必须首先启用上面所述的鼠标跟踪。然后，为了确保工具提示立即被更新，您必须在mouseMoveEvent()的实现中调用<a href="qtooltip.html#showText">QToolTip::showText</a>()而不是<a href="qwidget.html#toolTip-prop">setToolTip</a>()。</p>
<p><b>请参考 </b><a href="qwidget.html#mouseTracking-prop">setMouseTracking</a>(), <a href="qwidget.html#mousePressEvent">mousePressEvent</a>(), <a href="qwidget.html#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="qwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="qwidget.html#event">event</a>(), <a href="../qtgui/qmouseevent.html">QMouseEvent</a>,
<span lang="zh-cn">和 </span><a href="qtwidgets-widgets-scribble-example.html">
<span lang="zh-cn">潦草的案例</span></a><span lang="zh-cn">。</span></p>
<!-- @@@mouseMoveEvent -->
<!-- $$$mousePressEvent[overload1]$$$mousePressEventQMouseEvent* -->
<h3 class="fn" id="mousePressEvent"><a name="mousePressEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">mousePressEvent</span>(<span class="type"><a href="../qtgui/qmouseevent.html">QMouseEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于<span lang="zh-cn">鼠标按下事件</span> </font>
<i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现，以<span lang="zh-cn">自定义处理</span>组件的鼠标按下事件。</font></p>
<p><font style="vertical-align: inherit;">如果您在 mousePressEvent() 中创建新的组件，则</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#mouseReleaseEvent"><font style="vertical-align: inherit;">mouseReleaseEvent</font></a><font style="vertical-align: inherit;"> () 可能不会在您期望的位置结束，这取决于底层窗口系统（或 X11 窗口管理器）、组件的位置以及<span lang="zh-cn">其他的原因</span>。</font></p>
<p><font style="vertical-align: inherit;">当您在窗口外单击时，默认实现会关闭弹出窗口组件。对于其他组件类型，它什么都不做。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mouseReleaseEvent">mouseReleaseEvent</a>(), <a href="qwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>(), <a href="qwidget.html#event">event</a>(), <a href="../qtgui/qmouseevent.html">QMouseEvent</a>,
<span lang="zh-cn">和 <a href="qtwidgets-widgets-scribble-example.html">潦草的案例</a></span>.</p>
<!-- @@@mousePressEvent -->
<!-- $$$mouseReleaseEvent[overload1]$$$mouseReleaseEventQMouseEvent* -->
<h3 class="fn" id="mouseReleaseEvent"><a name="mouseReleaseEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">mouseReleaseEvent</span>(<span class="type"><a href="../qtgui/qmouseevent.html">QMouseEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于<span lang="zh-cn">鼠标释放事件</span> </font>
<i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现，以<span lang="zh-cn">自定义处理</span>组件的鼠标释放事件。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mousePressEvent">mousePressEvent</a>(), <a href="qwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(), <a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>(), <a href="qwidget.html#event">event</a>(), <a href="../qtgui/qmouseevent.html">QMouseEvent</a>,
<span lang="zh-cn">和</span> <span lang="zh-cn">
<a href="qtwidgets-widgets-scribble-example.html">潦草的案例</a>。</span></p>
<!-- @@@mouseReleaseEvent -->
<!-- $$$move -->
<h3 class="fn" id="move-1"><a name="move-1"></a><span class="type">void</span> QWidget::<span class="name">move</span>(<span class="type">int</span> <i>x</i>, <span class="type">int</span> <i>y</i>)</h3>
<p><span lang="zh-cn">这是一个重载函数。</span></p>
<p><span lang="zh-cn">这个对应于</span> move(<a href="../qtcore/qpoint.html">QPoint</a>(<i>x</i>, <i>y</i>))<span lang="zh-cn">。</span></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#pos-prop"><font style="vertical-align: inherit;">pos 的</font></a><span lang="zh-cn">设置</span><font style="vertical-align: inherit;">函数。</font></p><!-- @@@move -->
<!-- $$$moveEvent[overload1]$$$moveEventQMoveEvent* -->
<h3 class="fn" id="moveEvent"><a name="moveEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">moveEvent</span>(<span class="type"><a href="../qtgui/qmoveevent.html">QMoveEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现，以接收在</font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">参数中传递的组件移动事件。当组件收到此事件时，它已经在新位置。</font></p>
<p><font style="vertical-align: inherit;">旧位置可通过</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qmoveevent.html#oldPos"><font style="vertical-align: inherit;">QMoveEvent::oldPos</font></a><font style="vertical-align: inherit;"> () 访问。</font></p>
<p><b>请参考 </b><a href="qwidget.html#resizeEvent">resizeEvent</a>(), <a href="qwidget.html#event">event</a>(), <a href="qwidget.html#pos-prop">move</a>(),
<span lang="zh-cn">和 </span><a href="../qtgui/qmoveevent.html">QMoveEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@moveEvent -->
<!-- $$$nativeEvent[overload1]$$$nativeEventconstQByteArray&void*long* -->
<h3 class="fn" id="nativeEvent"><a name="nativeEvent"></a><code>[virtual protected] </code><span class="type">bool</span> QWidget::<span class="name">nativeEvent</span>(const <span class="type"><a href="../qtcore/qbytearray.html">QByteArray</a></span> &amp;<i>eventType</i>, <span class="type">void</span> *<i>message</i>, <span class="type">long</span> *<i>result</i>)</h3>
<p><font style="vertical-align: inherit;">这个特殊的事件处理程序可以在子类中重新实现，以接收由</font><i><font style="vertical-align: inherit;">eventType</font></i><font style="vertical-align: inherit;">标识的本地平台事件，这些事件在</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">message(消息）</span></font></i><font style="vertical-align: inherit;">参数中传递。</font></p>
<p><font style="vertical-align: inherit;">在您重新实现此函数时，如果您想停止 Qt 正在处理的事件，请返回 true 并设置</font><i><font style="vertical-align: inherit;">result</font></i><font style="vertical-align: inherit;">。该</font><i><font style="vertical-align: inherit;">result</font></i><font style="vertical-align: inherit;">参数在Windows上才有意义。如果返回 false，则此原生事件将传递回 Qt，Qt 将事件转换为 Qt 事件并将其发送到组件。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">只有当组件具有本机窗口句柄时，才会将事件传递给此事件处理程序。</font></p><p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">该函数取代了 Qt 4 的事件过滤函数 x11Event()、winEvent() 和 macEvent()。</font></p><div class="table"><table class="generic">
 <thead><tr class="qt-style"><th ><span lang="zh-cn">平台</span></th><th >
	 <span lang="zh-cn">事件类型标识</span></th><th ><span lang="zh-cn">事件类型</span></th><th >
	 <span lang="zh-cn">结果类型</span></th></tr></thead>
<tr valign="top" class="odd"><td >Windows</td><td >&quot;windows_generic_MSG&quot;</td><td >MSG *</td><td >LRESULT</td></tr>
<tr valign="top" class="even"><td ><a href="../qtdoc/internationalization.html#macos">macOS</a></td><td >&quot;NSEvent&quot;</td><td >NSEvent *</td><td ></td></tr>
<tr valign="top" class="odd"><td >XCB</td><td >&quot;xcb_generic_event_t&quot;</td><td >xcb_generic_event_t *</td><td ></td></tr>
</table></div>
<p><b>请参考 </b><a href="../qtcore/qabstractnativeeventfilter.html">QAbstractNativeEventFilter</a><span lang="zh-cn">。</span></p>
<!-- @@@nativeEvent -->
<!-- $$$nativeParentWidget[overload1]$$$nativeParentWidget -->
<h3 class="fn" id="nativeParentWidget"><a name="nativeParentWidget"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">nativeParentWidget</span>() const</h3>
<p><font style="vertical-align: inherit;">返回此组件的原生父组件，即具有系统标识符的下一个祖先组件，如果没有任何原生父组件，则返回 0。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.4 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#effectiveWinId">effectiveWinId</a>()<span lang="zh-cn">。</span></p>
<!-- @@@nativeParentWidget -->
<!-- $$$nextInFocusChain[overload1]$$$nextInFocusChain -->
<h3 class="fn" id="nextInFocusChain"><a name="nextInFocusChain"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">nextInFocusChain</span>() const</h3>
<p><font style="vertical-align: inherit;">返回此组件焦点链中的下一个组件。</font></p>
<p><b>请参考 </b><a href="qwidget.html#previousInFocusChain">previousInFocusChain</a>()<span lang="zh-cn">。</span></p>
<!-- @@@nextInFocusChain -->
<!-- $$$overrideWindowFlags[overload1]$$$overrideWindowFlagsQt::WindowFlags -->
<h3 class="fn" id="overrideWindowFlags"><a name="overrideWindowFlags"></a><span class="type">void</span> QWidget::<span class="name">overrideWindowFlags</span>(<span class="type"><a href="../qtcore/qt.html#WindowType-enum">Qt::WindowFlags</a></span> <i>flags</i>)</h3>
<p><font style="vertical-align: inherit;">将窗口组件的窗口标志设置为</font><i><font style="vertical-align: inherit;">flags</font></i><font style="vertical-align: inherit;">，</font><i><font style="vertical-align: inherit;">而不</font></i><font style="vertical-align: inherit;">告诉窗口系统。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">除非你真的知道你在做什么，否则不要调用这个函数。</font></p>
<p><b>请参考 </b><a href="qwidget.html#windowFlags-prop">setWindowFlags</a>()<span lang="zh-cn">。</span></p>
<!-- @@@overrideWindowFlags -->
<!-- $$$paintEngine[overload1]$$$paintEngine -->
<h3 class="fn" id="paintEngine"><a name="paintEngine"></a><code>[override virtual] </code><span class="type"><a href="../qtgui/qpaintengine.html">QPaintEngine</a></span> *QWidget::<span class="name">paintEngine</span>() const</h3>
<p><font style="vertical-align: inherit;">从</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpaintdevice.html#paintEngine"><font style="vertical-align: inherit;">QPaintDevice::paintEngine</font></a><font style="vertical-align: inherit;"> ()重新实现。</font></p>
<p><font style="vertical-align: inherit;">返回组件的绘制引擎。</font></p>
<p><font style="vertical-align: inherit;">请注意，此函数不应由用户显式调用，因为它仅用于重新实现的目的。该函数由 Qt 内部调用，默认实现可能并不总是返回有效指针。</font></p>
<!-- @@@paintEngine -->
<!-- $$$paintEvent[overload1]$$$paintEventQPaintEvent* -->
<h3 class="fn" id="paintEvent"><a name="paintEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">paintEvent</span>(<span class="type"><a href="../qtgui/qpaintevent.html">QPaintEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现，以接收在</font><i><font style="vertical-align: inherit;">event 中</font></i><font style="vertical-align: inherit;">传递的绘制<i>事件<span lang="zh-cn">（</span>even<span lang="zh-cn">t）</span></i>。</font></p>
<p><font style="vertical-align: inherit;">绘制事件是重新绘制全部或部分组件的请求。它可能由于以下原因之一而发生：</font></p>
<ul>
<li><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#repaint"><font style="vertical-align: inherit;">repaint</font></a><font style="vertical-align: inherit;"> () 或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update"><font style="vertical-align: inherit;">update</font></a><font style="vertical-align: inherit;"> () 被调用</font></li>
<li><span lang="zh-cn">组件曾被遮挡，但现在显露出来了</span></li>
<li><span lang="zh-cn">其他众多原因</span></li>
</ul>
<p><font style="vertical-align: inherit;">许多组件可以在被要求时简单地重新绘制它们的整个表面，但一些缓慢的组件需要通过仅绘制请求的区域来优化：</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpaintevent.html#region"><font style="vertical-align: inherit;">QPaintEvent::region</font></a><font style="vertical-align: inherit;"> ()。这种速度优化不会改变结果，因为在事件处理期间绘图会被裁剪到该区域。例如，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlistview.html"><font style="vertical-align: inherit;">QListView</font></a><font style="vertical-align: inherit;">和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qtableview.html"><font style="vertical-align: inherit;">QTableView</font></a><font style="vertical-align: inherit;">就是这样做的。</font></p>
<p><font style="vertical-align: inherit;">Qt 还尝试通过将多个绘制事件合并为一个来加速绘制。当多次调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update"><font style="vertical-align: inherit;">update</font></a><font style="vertical-align: inherit;"> () 或窗口系统发送多个绘制事件时，Qt 会将这些事件合并为一个具有更大区域的事件（参见</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qregion.html#united-1"><font style="vertical-align: inherit;">QRegion::united</font></a><font style="vertical-align: inherit;"> ()）。该<a href="qwidget.html#repaint">repaint</a>（）函数不允许这种优化，所以只要有可能<span lang="zh-cn">，</span>我们建议您使用<a href="qwidget.html#update">update</a>（）。</font></p>
<p><font style="vertical-align: inherit;">绘制事件发生时，更新区域通常已被擦除，因此您正在组件的背景上进行绘制。</font></p>
<p><font style="vertical-align: inherit;">可以使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setBackgroundRole"><font style="vertical-align: inherit;">setBackgroundRole</font></a><font style="vertical-align: inherit;"> () 和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#palette-prop"><font style="vertical-align: inherit;">setPalette</font></a><font style="vertical-align: inherit;"> ()设置背景。</font></p>
<p><font style="vertical-align: inherit;">从Qt 4.0开始，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">自动对其绘制进行双缓冲，因此无需在paintEvent()中编写双缓冲代码来避免闪烁。</font></p>
<p><b>注意: </b>通常，您应该避免在paintEvent()中调用<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update"><font style="vertical-align: inherit;">update</font></a>()或<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#repaint"><font style="vertical-align: inherit;">repaint</font></a>()。例如，在paintEvent()中调用<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update"><font style="vertical-align: inherit;">update</font></a>()或<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#repaint"><font style="vertical-align: inherit;">repaint</font></a>()会导致未定义的行为;孩子可能会<span lang="zh-cn">获得绘制事件</span>，也可能不会。</p><p>
	<b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">如果您使用没有 Qt</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum"><font style="vertical-align: inherit;">后<span lang="zh-cn">台</span>存储</font></a><font style="vertical-align: inherit;">的自定义绘制引擎，<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum">则</a>必须设置<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum">Qt::WA_PaintOnScreen</a>。否则永远不会调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#paintEngine"><font style="vertical-align: inherit;">QWidget::paintEngine</font></a><font style="vertical-align: inherit;"> ()<span lang="zh-cn">，</span>将使用  
	<span lang="zh-cn">Qt的</span><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum">后<span lang="zh-cn">台</span>存储</a>。</font></p>
<p><b>请参考 </b><a href="qwidget.html#event">event</a>(), <a href="qwidget.html#repaint">repaint</a>(), <a href="qwidget.html#update">update</a>(), <a href="../qtgui/qpainter.html">QPainter</a>, <a href="../qtgui/qpixmap.html">QPixmap</a>, <a href="../qtgui/qpaintevent.html">QPaintEvent</a>,
<span lang="zh-cn">和&nbsp; </span>
<a href="qtwidgets-widgets-analogclock-example.html">模拟时钟的<span lang="zh-cn">案例</span></a>.</p>
<!-- @@@paintEvent -->
<!-- $$$parentWidget[overload1]$$$parentWidget -->
<h3 class="fn" id="parentWidget"><a name="parentWidget"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">parentWidget</span>() const</h3>
<p><font style="vertical-align: inherit;">返回此组件的父级，如果没有任何父级组件，则返回 0。</font></p>
<!-- @@@parentWidget -->
<!-- $$$previousInFocusChain[overload1]$$$previousInFocusChain -->
<h3 class="fn" id="previousInFocusChain"><a name="previousInFocusChain"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">previousInFocusChain</span>() const</h3>
<p><font style="vertical-align: inherit;">previousInFocusChain 函数返回此组件焦点链中的前一个组件。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.6 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#nextInFocusChain">nextInFocusChain</a>()<span lang="zh-cn">。</span></p>
<!-- @@@previousInFocusChain -->
<!-- $$$raise[overload1]$$$raise -->
<h3 class="fn" id="raise"><a name="raise"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">raise</span>()</h3>
<p><font style="vertical-align: inherit;">将此组件提升到父组件堆栈的顶部。</font></p>
<p><font style="vertical-align: inherit;">在此调用之后，组件将在视觉上位于任何重叠的同级组件之前。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">在使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#activateWindow"><font style="vertical-align: inherit;">activateWindow</font></a><font style="vertical-align: inherit;"> () 时，可以调用这个函数来保证窗口是堆叠在最上面的。</font></p><p><b>请参考 </b><a href="qwidget.html#lower">lower</a>()
	<span lang="zh-cn">和 </span><a href="qwidget.html#stackUnder">stackUnder</a>()<span lang="zh-cn">。</span></p>
<!-- @@@raise -->
<!-- $$$releaseKeyboard[overload1]$$$releaseKeyboard -->
<h3 class="fn" id="releaseKeyboard"><a name="releaseKeyboard"></a><span class="type">void</span> QWidget::<span class="name">releaseKeyboard</span>()</h3>
<p><font style="vertical-align: inherit;">释放键盘抓取。</font></p>
<p><b>请参考 </b><a href="qwidget.html#grabKeyboard">grabKeyboard</a>(), <a href="qwidget.html#grabMouse">grabMouse</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#releaseMouse">releaseMouse</a>()<span lang="zh-cn">。</span></p>
<!-- @@@releaseKeyboard -->
<!-- $$$releaseMouse[overload1]$$$releaseMouse -->
<h3 class="fn" id="releaseMouse"><a name="releaseMouse"></a><span class="type">void</span> QWidget::<span class="name">releaseMouse</span>()</h3>
<p><font style="vertical-align: inherit;">释放鼠标抓取。</font></p>
<p><b>请参考 </b><a href="qwidget.html#grabMouse">grabMouse</a>(), <a href="qwidget.html#grabKeyboard">grabKeyboard</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#releaseKeyboard">releaseKeyboard</a>()<span lang="zh-cn">。</span></p>
<!-- @@@releaseMouse -->
<!-- $$$releaseShortcut[overload1]$$$releaseShortcutint -->
<h3 class="fn" id="releaseShortcut"><a name="releaseShortcut"></a><span class="type">void</span> QWidget::<span class="name">releaseShortcut</span>(<span class="type">int</span> <i>id</i>)</h3>
<p><font style="vertical-align: inherit;">从 Qt 的快捷方式系统中删除具有给定</font><i><font style="vertical-align: inherit;">id</font></i><font style="vertical-align: inherit;">的快捷方式。组件将不再接收</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">快捷</font></a><font style="vertical-align: inherit;">键的按键序列的<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum">QEvent::Shortcut</a>事件（除非它有其他具有相同按键序列的快捷键）。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">您通常不需要使用此功能，因为 Qt 的快捷方式系统会在其父组件被销毁时自动删除快捷方式。最好使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qaction.html"><font style="vertical-align: inherit;">QAction</font></a><font style="vertical-align: inherit;">或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qshortcut.html"><font style="vertical-align: inherit;">QShortcut</font></a><font style="vertical-align: inherit;">来处理快捷方式，因为它们比这个低级函数更容易使用。另请注意，这是一项<span lang="zh-cn">开销很大</span>的操作。</font></p>
<p><b>请参考 </b><a href="qwidget.html#grabShortcut">grabShortcut</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#setShortcutEnabled">setShortcutEnabled</a>()<span lang="zh-cn">。</span></p>
<!-- @@@releaseShortcut -->
<!-- $$$removeAction[overload1]$$$removeActionQAction* -->
<h3 class="fn" id="removeAction"><a name="removeAction"></a><span class="type">void</span> QWidget::<span class="name">removeAction</span>(<span class="type"><a href="qaction.html">QAction</a></span> *<i>action</i>)</h3>
<p><font style="vertical-align: inherit;">从这个小工具的<span lang="zh-cn">动作</span>列表<span lang="zh-cn">中</span>删除动作</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">action</span></font></i><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#insertAction">insertAction</a>(), <a href="qwidget.html#actions">actions</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#insertAction">insertAction</a>()<span lang="zh-cn">。</span></p>
<!-- @@@removeAction -->
<!-- $$$render[overload1]$$$renderQPaintDevice*constQPoint&constQRegion&QWidget::RenderFlags -->
<h3 class="fn" id="render"><span class="type">void</span> QWidget::<span class="name">render</span>(<span class="type"><a href="../qtgui/qpaintdevice.html#QPaintDevice">QPaintDevice</a></span> *<i>target</i>, const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>targetOffset</i> = QPoint(), const <span class="type"><a href="../qtgui/qregion.html">QRegion</a></span> &amp;<i>sourceRegion</i> = QRegion(), <span class="type"><a href="qwidget.html#RenderFlag-enum">QWidget::RenderFlags</a></span> <i>renderFlags</i> = ...)</h3>
<p>使用renderFlags将这个组件的sourceRegion<span lang="zh-cn">（源区域）</span>渲染到目标，以确定如何渲染。渲染开始于目标中的targetOffset。例如:</p>
<pre class="cpp">

  <span class="type"><a href="../qtgui/qpixmap.html">QPixmap</a></span> pixmap(widget<span class="operator">-</span><span class="operator">&gt;</span>size());
  widget<span class="operator">-</span><span class="operator">&gt;</span>render(<span class="operator">&amp;</span>pixmap);

</pre>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">sourceRegion</font></i><font style="vertical-align: inherit;">为空区域，该函数将使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#rect-prop"><font style="vertical-align: inherit;">QWidget::rect</font></a><font style="vertical-align: inherit;"> 
() 作为区域，即整个<span lang="zh-cn">组件的区域</span>。</font></p>
<p><font style="vertical-align: inherit;">确保在渲染之前为<i>目标</i>设备的活动画家（如果有）调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpainter.html#end"><font style="vertical-align: inherit;">QPainter::end</font></a><font style="vertical-align: inherit;"> () 。例如：</font></p>
<pre class="cpp">

  <span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span> painter(<span class="keyword">this</span>);
  <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>
  painter<span class="operator">.</span>end();
  myWidget<span class="operator">-</span><span class="operator">&gt;</span>render(<span class="keyword">this</span>);

</pre>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">要获取</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qopenglwidget.html"><font style="vertical-align: inherit;">QOpenGLWidget</font></a><font style="vertical-align: inherit;">的内容，请改用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qopenglwidget.html#grabFramebuffer"><font style="vertical-align: inherit;">QOpenGLWidget::grabFramebuffer</font></a><font style="vertical-align: inherit;"> ()。</font></p><p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">要获取 QGLWidget（已弃用）的内容，请改用 QGLWidget::grabFrameBuffer() 或 QGLWidget::renderPixmap()。</font></p><p><font style="vertical-align: inherit;">这个函数是在 Qt 4.3 中引入的。</font></p>
<!-- @@@render -->
<!-- $$$render$$$renderQPainter*constQPoint&constQRegion&QWidget::RenderFlags -->
<h3 class="fn" id="render-1"><a name="render-1"></a><span class="type">void</span> QWidget::<span class="name">render</span>(<span class="type"><a href="../qtgui/qpainter.html">QPainter</a></span> *<i>painter</i>, const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &amp;<i>targetOffset</i> = QPoint(), const <span class="type"><a href="../qtgui/qregion.html">QRegion</a></span> &amp;<i>sourceRegion</i> = QRegion(), <span class="type"><a href="qwidget.html#RenderFlag-enum">QWidget::RenderFlags</a></span> <i>renderFlags</i> = ...)</h3>
<p><span lang="zh-cn">这是一个重载函数</span></p>
<p><font style="vertical-align: inherit;">将组件渲染到</font><i><font style="vertical-align: inherit;">painter</font></i><font style="vertical-align: inherit;">的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpainter.html#device"><font style="vertical-align: inherit;">QPainter::device</font></a><font style="vertical-align: inherit;"> () 中。</font></p>
<p><font style="vertical-align: inherit;">渲染时将使用应用于</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">painter（画家）</span>的</font></i><font style="vertical-align: inherit;">变换和设置。</font></p>
<p><b><font style="vertical-align: inherit;">注<span lang="zh-cn">意</span>：</font></b><font style="vertical-align: inherit;">该</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">painter（画家）</span></font></i><font style="vertical-align: inherit;">必须有效。在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtdoc/internationalization.html#macos"><font style="vertical-align: inherit;">macOS 上</font></a><font style="vertical-align: inherit;">，widget 将被渲染为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpixmap.html"><font style="vertical-align: inherit;">QPixmap</font></a><font style="vertical-align: inherit;">，然后由</font><i><font style="vertical-align: inherit;">painter</font></i><font style="vertical-align: inherit;">绘制。</font></p><p><b>请参考 </b><a href="../qtgui/qpainter.html#device">QPainter::device</a>()<span lang="zh-cn">。</span></p>
<!-- @@@render -->
<!-- $$$repaint[overload1]$$$repaint -->
<h3 class="fn" id="repaint"><a name="repaint"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">repaint</span>()</h3>
<p><font style="vertical-align: inherit;">通过立即调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#paintEvent"><font style="vertical-align: inherit;">paintEvent</font></a><font style="vertical-align: inherit;"> ()直接重新绘制组件，除非禁用更新或隐藏组件。</font></p>
<p><font style="vertical-align: inherit;">我们建议仅在需要立即重绘时使用 repaint()，例如在动画期间。在几乎所有情况下</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update"><font style="vertical-align: inherit;">update</font></a><font style="vertical-align: inherit;"> () 都更好，因为它允许 Qt 优化速度并最小化闪烁。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">如果您在一个函数中调用 repaint()，而该函数本身可能会从</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#paintEvent"><font style="vertical-align: inherit;">paintEvent</font></a><font style="vertical-align: inherit;"> ()调用，您可能会得到无限递归。</font><span lang="zh-cn">而</span><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#update"><font style="vertical-align: inherit;"><a href="qwidget.html#update">update</a></font></a><font style="vertical-align: inherit;">（）函数永远不会导致递归。</font></p>
<p><b>请参考 </b><a href="qwidget.html#update">update</a>(), <a href="qwidget.html#paintEvent">paintEvent</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#updatesEnabled-prop">setUpdatesEnabled</a>()<span lang="zh-cn">。</span></p>
<!-- @@@repaint -->
<!-- $$$repaint$$$repaintintintintint -->
<h3 class="fn" id="repaint-1"><a name="repaint-1"></a><span class="type">void</span> QWidget::<span class="name">repaint</span>(<span class="type">int</span> <i>x</i>, <span class="type">int</span> <i>y</i>, <span class="type">int</span> <i>w</i>, <span class="type">int</span> <i>h</i>)</h3>
<p><span lang="zh-cn">这是一个重载函数。</span></p>
<p><font style="vertical-align: inherit;">此版本<span lang="zh-cn">将</span>重新绘制<span lang="zh-cn">组件的</span>矩形<span lang="zh-cn">区域</span>（</font><i><font style="vertical-align: inherit;">x</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">y</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">h</font></i><font style="vertical-align: inherit;">）。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">为负，则替换为</font><code>width() - x</code><font style="vertical-align: inherit;">，如果</font><i><font style="vertical-align: inherit;">h</font></i><font style="vertical-align: inherit;">为负，则替换为 </font>
<code>height() - y</code><font style="vertical-align: inherit;">。</font></p>
<!-- @@@repaint -->
<!-- $$$repaint$$$repaintconstQRect& -->
<h3 class="fn" id="repaint-2"><a name="repaint-2"></a><span class="type">void</span> QWidget::<span class="name">repaint</span>(const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span> &amp;<i>rect</i>)</h3>
<p>T<span lang="zh-cn">这是一个重载函数。</span></p>
<p><font style="vertical-align: inherit;">此版本在组件内重新绘制矩形</font><i><font style="vertical-align: inherit;"><span lang="zh-cn">区域</span>rect</font></i><font style="vertical-align: inherit;">。</font></p>
<!-- @@@repaint -->
<!-- $$$repaint$$$repaintconstQRegion& -->
<h3 class="fn" id="repaint-3"><a name="repaint-3"></a><span class="type">void</span> QWidget::<span class="name">repaint</span>(const <span class="type"><a href="../qtgui/qregion.html">QRegion</a></span> &amp;<i>rgn</i>)</h3>
<p><span lang="zh-cn">这是一个重载函数。</span></p>
<p><font style="vertical-align: inherit;">此版本在组件内重新绘制区域</font><i><font style="vertical-align: inherit;">rgn</font></i><font style="vertical-align: inherit;">。</font></p>
<!-- @@@repaint -->
<!-- $$$resize -->
<h3 class="fn" id="resize-1"><a name="resize-1"></a><span class="type">void</span> QWidget::<span class="name">resize</span>(<span class="type">int</span> <i>w</i>, <span class="type">int</span> <i>h</i>)</h3>
<p><span lang="zh-cn">这是一个重载函数。</span></p>
<p><font style="vertical-align: inherit;">这对应于 resize( </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qsize.html"><font style="vertical-align: inherit;">QSize</font></a><font style="vertical-align: inherit;"> ( </font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;"> , </font><i><font style="vertical-align: inherit;">h</font></i><font style="vertical-align: inherit;"> ))。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;"><span lang="zh-cn">这是</span>属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#size-prop"><font style="vertical-align: inherit;">size 的</font></a><span lang="zh-cn">设置</span><font style="vertical-align: inherit;">函数。</font></p><!-- @@@resize -->
<!-- $$$resizeEvent[overload1]$$$resizeEventQResizeEvent* -->
<h3 class="fn" id="resizeEvent"><a name="resizeEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">resizeEvent</span>(<span class="type"><a href="../qtgui/qresizeevent.html">QResizeEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现，以接收在</font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">参数中传递的组件调整大小事件。当 resizeEvent() 被调用时，组件已经有了它的新几何形状。可以通过</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qresizeevent.html#oldSize"><font style="vertical-align: inherit;">QResizeEvent::oldSize</font></a><font style="vertical-align: inherit;"> ()访问旧大小。</font></p>
<p><font style="vertical-align: inherit;">在处理调整大小事件后，组件将被擦除并立即接收绘制事件。无需（或应该）在此处理程序内完成绘图。</font></p>
<p><b>请参考 </b><a href="qwidget.html#moveEvent">moveEvent</a>(), <a href="qwidget.html#event">event</a>(), <a href="qwidget.html#size-prop">resize</a>(), <a href="../qtgui/qresizeevent.html">QResizeEvent</a>, <a href="qwidget.html#paintEvent">paintEvent</a>(),
<span lang="zh-cn">和 </span><a href="qtwidgets-widgets-scribble-example.html">
<span lang="zh-cn">潦草的案例</span></a>.</p>
<!-- @@@resizeEvent -->
<!-- $$$restoreGeometry[overload1]$$$restoreGeometryconstQByteArray& -->
<h3 class="fn" id="restoreGeometry"><a name="restoreGeometry"></a><span class="type">bool</span> QWidget::<span class="name">restoreGeometry</span>(const <span class="type"><a href="../qtcore/qbytearray.html">QByteArray</a></span> &amp;<i>geometry</i>)</h3>
<p><font style="vertical-align: inherit;">恢复存储在字节数组</font><i><font style="vertical-align: inherit;">geometry 中</font></i><font style="vertical-align: inherit;">的顶级组件的几何形状和状态。成功返回<code>true</code>；否则返回</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p>如果恢复的几何图形不在屏幕上，它将被修改为在可用的屏幕几何图形内。</p>
<p><font style="vertical-align: inherit;">要恢复使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qsettings.html"><font style="vertical-align: inherit;">QSettings</font></a><font style="vertical-align: inherit;">保存的<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qsettings.html">几何图形</a>，您可以使用如下代码：</font></p>
<pre class="cpp">

  <span class="type"><a href="../qtcore/qsettings.html">QSettings</a></span> settings(<span class="string">&quot;MyCompany&quot;</span><span class="operator">,</span> <span class="string">&quot;MyApp&quot;</span>);
  myWidget<span class="operator">-</span><span class="operator">&gt;</span>restoreGeometry(settings<span class="operator">.</span>value(<span class="string">&quot;myWidget/geometry&quot;</span>)<span class="operator">.</span>toByteArray());

</pre>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><font style="vertical-align: inherit;">使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qmainwindow.html#restoreState"><font style="vertical-align: inherit;">QMainWindow::restoreState</font></a><font style="vertical-align: inherit;"> () 恢复工具栏和停靠组件的几何形状和状态。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.2 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#saveGeometry">saveGeometry</a>(), <a href="../qtcore/qsettings.html">QSettings</a>, <a href="qmainwindow.html#saveState">QMainWindow::saveState</a>(),
<span lang="zh-cn">和 </span><a href="qmainwindow.html#restoreState">QMainWindow::restoreState</a>()<span lang="zh-cn">。</span></p>
<!-- @@@restoreGeometry -->
<!-- $$$saveGeometry[overload1]$$$saveGeometry -->
<h3 class="fn" id="saveGeometry"><a name="saveGeometry"></a><span class="type"><a href="../qtcore/qbytearray.html">QByteArray</a></span> QWidget::<span class="name">saveGeometry</span>() const</h3>
<p><font style="vertical-align: inherit;">保存顶级组件的当前几何形状和状态。</font></p>
<p><font style="vertical-align: inherit;">要在窗口关闭时保存几何图形，您可以实现如下关闭事件：</font></p>
<pre class="cpp">

  <span class="type">void</span> MyWidget<span class="operator">::</span>closeEvent(<span class="type"><a href="../qtgui/qcloseevent.html">QCloseEvent</a></span> <span class="operator">*</span>event)
  {
      <span class="type"><a href="../qtcore/qsettings.html">QSettings</a></span> settings(<span class="string">&quot;MyCompany&quot;</span><span class="operator">,</span> <span class="string">&quot;MyApp&quot;</span>);
      settings<span class="operator">.</span>setValue(<span class="string">&quot;geometry&quot;</span><span class="operator">,</span> saveGeometry());
      <span class="type"><a href="qwidget.html#QWidget">QWidget</a></span><span class="operator">::</span>closeEvent(event);
  }

</pre>
<p><font style="vertical-align: inherit;">有关</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">问题的概述，请参阅<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry">窗口几何</a>文档。</font></p>
<p><font style="vertical-align: inherit;">使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qmainwindow.html#saveState"><font style="vertical-align: inherit;">QMainWindow::saveState</font></a><font style="vertical-align: inherit;"> () 来保存几何图形以及工具栏和停靠组件的状态。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.2 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#restoreGeometry">restoreGeometry</a>(), <a href="qmainwindow.html#saveState">QMainWindow::saveState</a>(),
<span lang="zh-cn">和&nbsp; </span><a href="qmainwindow.html#restoreState">QMainWindow::restoreState</a>()<span lang="zh-cn">。</span></p>
<!-- @@@saveGeometry -->
<!-- $$$scroll[overload1]$$$scrollintint -->
<h3 class="fn" id="scroll"><a name="scroll"></a><span class="type">void</span> QWidget::<span class="name">scroll</span>(<span class="type">int</span> <i>dx</i>, <span class="type">int</span> <i>dy</i>)</h3>
<p><font style="vertical-align: inherit;">将组件及其子组件向右滚动</font><i><font style="vertical-align: inherit;">dx</font></i><font style="vertical-align: inherit;">像素，向下滚动</font><i><font style="vertical-align: inherit;">dy</font></i><font style="vertical-align: inherit;">。这两个<span lang="zh-cn">dx</span>和<span lang="zh-cn">dy</span>可能是负的。</font></p>
<p><font style="vertical-align: inherit;">滚动后，组件将接收需要重新绘制的区域的绘制事件。对于 Qt 知道不透明的组件，这只是新暴露的部分。例如，如果一个不透明的组件向左滚动 8 像素，则只有右边缘的 8 像素宽条纹需要更新。</font></p>
<p><font style="vertical-align: inherit;">由于组件默认传播其父级的内容，因此需要设置</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#autoFillBackground-prop"><font style="vertical-align: inherit;">autoFillBackground</font></a><font style="vertical-align: inherit;">属性，或者使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setAttribute"><font style="vertical-align: inherit;">setAttribute</font></a><font style="vertical-align: inherit;"> ()设置</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum"><font style="vertical-align: inherit;">Qt::WA_OpaquePaintEvent</font></a><font style="vertical-align: inherit;">属性，使组件不透明。</font></p>
<p><font style="vertical-align: inherit;">对于使用内容传播的组件，滚动将导致整个滚动区域的更新。</font></p>
<p><b>请参考 <a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#transparency-and-double-buffering"><font style="vertical-align: inherit;">透明和双缓冲</font></a><span lang="zh-cn">。</span></b></p>
<!-- @@@scroll -->
<!-- $$$scroll$$$scrollintintconstQRect& -->
<h3 class="fn" id="scroll-1"><a name="scroll-1"></a><span class="type">void</span> QWidget::<span class="name">scroll</span>(<span class="type">int</span> <i>dx</i>, <span class="type">int</span> <i>dy</i>, const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span> &amp;<i>r</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">此版本仅滚动</font><i><font style="vertical-align: inherit;">r</font></i><font style="vertical-align: inherit;">而不会移动组件的子项。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">r</font></i><font style="vertical-align: inherit;">为空或无效，则结果未定义。</font></p>
<p><b>请参考 </b><a href="qscrollarea.html">QScrollArea</a><span lang="zh-cn">。</span></p>
<!-- @@@scroll -->
<!-- $$$setAttribute[overload1]$$$setAttributeQt::WidgetAttributebool -->
<h3 class="fn" id="setAttribute"><a name="setAttribute"></a><span class="type">void</span> QWidget::<span class="name">setAttribute</span>(<span class="type"><a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WidgetAttribute</a></span> <i>attribute</i>, <span class="type">bool</span> <i>on</i> = true)</h3>
<p><font style="vertical-align: inherit;">如果<i>on</i>为真，则设置此组件的属性<i>attribute</i>；否则清除该属性。</font></p>
<p><b>请参考 </b><a href="qwidget.html#testAttribute">testAttribute</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setAttribute -->
<!-- $$$setBackgroundRole[overload1]$$$setBackgroundRoleQPalette::ColorRole -->
<h3 class="fn" id="setBackgroundRole"><a name="setBackgroundRole"></a><span class="type">void</span> QWidget::<span class="name">setBackgroundRole</span>(<span class="type"><a href="../qtgui/qpalette.html#ColorRole-enum">QPalette::ColorRole</a></span> <i>role</i>)</h3>
<p><font style="vertical-align: inherit;">将组件的背景角色设置为</font><i><font style="vertical-align: inherit;">role</font></i><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">背景角色定义了用于渲染背景的组件</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#palette-prop"><font style="vertical-align: inherit;">调色板</font></a><font style="vertical-align: inherit;">中的画笔。</font></p>
<p><font style="vertical-align: inherit;">如果<i>role</i> <span lang="zh-cn">（</span></font><i><font style="vertical-align: inherit;">角色<span lang="zh-cn">）</span></font></i><font style="vertical-align: inherit;">是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpalette.html#ColorRole-enum"><font style="vertical-align: inherit;">QPalette::NoRole</font></a><font style="vertical-align: inherit;">，则组件继承其父级的背景角色。</font></p>
<p><font style="vertical-align: inherit;">请注意，样式可以从调色板中自由选择任何颜色。如果使用 setBackgroundRole() 没有达到您想要的结果，您可以修改调色板或设置样式表。</font></p>
<p><b>请参考 </b><a href="qwidget.html#backgroundRole">backgroundRole</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#foregroundRole">foregroundRole</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setBackgroundRole -->
<!-- $$$setBaseSize -->
<h3 class="fn" id="setBaseSize-1"><a name="setBaseSize-1"></a><span class="type">void</span> QWidget::<span class="name">setBaseSize</span>(<span class="type">int</span> <i>basew</i>, <span class="type">int</span> <i>baseh</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">这对应于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#baseSize-prop"><font style="vertical-align: inherit;">setBaseSize</font></a><font style="vertical-align: inherit;"> ( </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qsize.html"><font style="vertical-align: inherit;">QSize</font></a><font style="vertical-align: inherit;"> ( </font><i><font style="vertical-align: inherit;">basew</font></i><font style="vertical-align: inherit;"> , </font><i><font style="vertical-align: inherit;">baseh</font></i><font style="vertical-align: inherit;"> ))。将组件基本大小设置为 width </font><i><font style="vertical-align: inherit;">basew</font></i><font style="vertical-align: inherit;">和 height </font><i><font style="vertical-align: inherit;">baseh</font></i><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#baseSize-prop"><font style="vertical-align: inherit;">baseSize 的</font></a><span lang="zh-cn">设置</span><font style="vertical-align: inherit;">函数。</font></p><!-- @@@setBaseSize -->
<!-- $$$setContentsMargins[overload1]$$$setContentsMarginsintintintint -->
<h3 class="fn" id="setContentsMargins"><a name="setContentsMargins"></a><span class="type">void</span> QWidget::<span class="name">setContentsMargins</span>(<span class="type">int</span> <i>left</i>, <span class="type">int</span> <i>top</i>, <span class="type">int</span> <i>right</i>, <span class="type">int</span> <i>bottom</i>)</h3>
<p><font style="vertical-align: inherit;">将组件内容周围的边距设置为</font><i><font style="vertical-align: inherit;">left</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">top</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">right</font></i><font style="vertical-align: inherit;">和</font><i><font style="vertical-align: inherit;">bottom</font></i><font style="vertical-align: inherit;">。边距由布局系统使用，并且可以由子类使用以指定要绘制的区域（例如，不包括框架）。</font></p>
<p><font style="vertical-align: inherit;">改变边距会触发一个</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#resizeEvent"><font style="vertical-align: inherit;">resizeEvent</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><b>请参考 </b><a href="qwidget.html#contentsMargins">contentsMargins</a>(), <a href="qwidget.html#contentsRect">contentsRect</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#getContentsMargins">getContentsMargins</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setContentsMargins -->
<!-- $$$setContentsMargins$$$setContentsMarginsconstQMargins& -->
<h3 class="fn" id="setContentsMargins-1"><a name="setContentsMargins-1"></a><span class="type">void</span> QWidget::<span class="name">setContentsMargins</span>(const <span class="type"><a href="../qtcore/qmargins.html">QMargins</a></span> &amp;<i>margins</i>)</h3>
<p>这是一个重载函数。</p>
<p><a href="qwidget.html#setContentsMargins">setContentsMargins</a>函数设置组件内容周围的边距。</p>
<p><font style="vertical-align: inherit;">将组件内容周围的边距设置为由</font><i><font style="vertical-align: inherit;">margins（边距）</font></i><font style="vertical-align: inherit;">确定的大小。边距由布局系统使用，并且可以由子类使用以指定要绘制的区域（例如，不包括框架）。</font></p>
<p><font style="vertical-align: inherit;">改变边距会触发一个</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#resizeEvent"><font style="vertical-align: inherit;">resizeEvent</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.6 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#contentsRect">contentsRect</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#getContentsMargins">getContentsMargins</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setContentsMargins -->
<!-- $$$setDisabled[overload1]$$$setDisabledbool -->
<h3 class="fn" id="setDisabled"><a name="setDisabled"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">setDisabled</span>(<span class="type">bool</span> <i>disable</i>)</h3>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">disable</font></i><font style="vertical-align: inherit;">为真，则禁用组件输入事件；否则启用输入事件。</font></p>
<p><font style="vertical-align: inherit;">有关更多信息，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#enabled-prop"><font style="vertical-align: inherit;">启用的</font></a><font style="vertical-align: inherit;">文档。</font></p>
<p><b>请参考 </b><a href="qwidget.html#isEnabledTo">isEnabledTo</a>(), <a href="../qtgui/qkeyevent.html">QKeyEvent</a>, <a href="../qtgui/qmouseevent.html">QMouseEvent</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#changeEvent">changeEvent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setDisabled -->
<!-- $$$setEditFocus[overload1]$$$setEditFocusbool -->
<h3 class="fn" id="setEditFocus"><a name="setEditFocus"></a><span class="type">void</span> QWidget::<span class="name">setEditFocus</span>(<span class="type">bool</span> <i>enable</i>)</h3>
<p>I<font style="vertical-align: inherit;">果</font><i><font style="vertical-align: inherit;">enable</font></i><font style="vertical-align: inherit;">为 true，则使该组件具有编辑焦点，在这种情况下，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#Key-enum"><font style="vertical-align: inherit;">Qt::Key_Up</font></a><font style="vertical-align: inherit;">和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#Key-enum"><font style="vertical-align: inherit;">Qt::Key_Down</font></a><font style="vertical-align: inherit;">将正常传递给组件；<span lang="zh-cn">另外</span>，使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#Key-enum"><font style="vertical-align: inherit;">Qt::Key_Up</font></a><font style="vertical-align: inherit;">和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#Key-enum"><font style="vertical-align: inherit;">Qt::Key_Down</font></a><font style="vertical-align: inherit;">来改变焦点。</font></p>
<p><font style="vertical-align: inherit;">此功能仅在 Qt for Embedded Linux 中可用。</font></p>
<p><b>请参考 </b><a href="qwidget.html#hasEditFocus">hasEditFocus</a>()
<span lang="zh-cn">和 </span>
<a href="qapplication-obsolete.html#keypadNavigationEnabled">QApplication::keypadNavigationEnabled</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setEditFocus -->
<!-- $$$setFixedHeight[overload1]$$$setFixedHeightint -->
<h3 class="fn" id="setFixedHeight"><a name="setFixedHeight"></a><span class="type">void</span> QWidget::<span class="name">setFixedHeight</span>(<span class="type">int</span> <i>h</i>)</h3>
<p><font style="vertical-align: inherit;">将组件的最小和最大高度都设置为</font><i><font style="vertical-align: inherit;">h</font></i><font style="vertical-align: inherit;">而不更改宽度。提供方便。</font></p>
<p><b>请参考 </b><a href="qwidget.html#sizeHint-prop">sizeHint</a>(), <a href="qwidget.html#minimumSize-prop">minimumSize</a>(), <a href="qwidget.html#maximumSize-prop">maximumSize</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#setFixedSize">setFixedSize</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setFixedHeight -->
<!-- $$$setFixedSize[overload1]$$$setFixedSizeconstQSize& -->
<h3 class="fn" id="setFixedSize"><a name="setFixedSize"></a><span class="type">void</span> QWidget::<span class="name">setFixedSize</span>(const <span class="type"><a href="../qtcore/qsize.html">QSize</a></span> &amp;<i>s</i>)</h3>
<p><font style="vertical-align: inherit;">将组件的最小和最大尺寸都设置为</font><i><font style="vertical-align: inherit;">s</font></i><font style="vertical-align: inherit;">，从而防止它不断增长或缩小。</font></p>
<p><font style="vertical-align: inherit;">这将覆盖</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlayout.html"><font style="vertical-align: inherit;">QLayout</font></a><font style="vertical-align: inherit;">设置的默认大小约束。</font></p>
<p><font style="vertical-align: inherit;">要移除约束，请将大小设置为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#QWIDGETSIZE_MAX"><font style="vertical-align: inherit;">QWIDGETSIZE_MAX</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">或者，如果您希望组件具有基于其内容的固定大小，您可以调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlayout.html#sizeConstraint-prop"><font style="vertical-align: inherit;">QLayout::setSizeConstraint</font></a><font style="vertical-align: inherit;"> ( </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlayout.html#SizeConstraint-enum"><font style="vertical-align: inherit;">QLayout::SetFixedSize</font></a><font style="vertical-align: inherit;"> );</font></p>
<p><b>请参考 </b><a href="qwidget.html#maximumSize-prop">maximumSize</a> 
<span lang="zh-cn">和 </span><a href="qwidget.html#minimumSize-prop">minimumSize</a><span lang="zh-cn">。</span></p>
<!-- @@@setFixedSize -->
<!-- $$$setFixedSize$$$setFixedSizeintint -->
<h3 class="fn" id="setFixedSize-1"><a name="setFixedSize-1"></a><span class="type">void</span> QWidget::<span class="name">setFixedSize</span>(<span class="type">int</span> <i>w</i>, <span class="type">int</span> <i>h</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">将组件的宽度设置为</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">，将高度设置为</font><i><font style="vertical-align: inherit;">h</font></i><font style="vertical-align: inherit;">。</font></p>
<!-- @@@setFixedSize -->
<!-- $$$setFixedWidth[overload1]$$$setFixedWidthint -->
<h3 class="fn" id="setFixedWidth"><a name="setFixedWidth"></a><span class="type">void</span> QWidget::<span class="name">setFixedWidth</span>(<span class="type">int</span> <i>w</i>)</h3>
<p><font style="vertical-align: inherit;">将组件的最小和最大宽度设置为</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">而不更改高度。提供方便。</font></p>
<p><b>请参考 </b><a href="qwidget.html#sizeHint-prop">sizeHint</a>(), <a href="qwidget.html#minimumSize-prop">minimumSize</a>(), <a href="qwidget.html#maximumSize-prop">maximumSize</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#setFixedSize">setFixedSize</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setFixedWidth -->
<!-- $$$setFocus[overload1]$$$setFocusQt::FocusReason -->
<h3 class="fn" id="setFocus"><a name="setFocus"></a><span class="type">void</span> QWidget::<span class="name">setFocus</span>(<span class="type"><a href="../qtcore/qt.html#FocusReason-enum">Qt::FocusReason</a></span> <i>reason</i>)</h3>
<p><font style="vertical-align: inherit;">如果此组件或其父级之一是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isActiveWindow-prop"><font style="vertical-align: inherit;">活动 window ，</font></a><font style="vertical-align: inherit;">则将键盘输入焦点赋予此组件（或其焦点代理）。该</font><i><font style="vertical-align: inherit;">reason 
（理由）</font></i><font style="vertical-align: inherit;">参数将被传递给这个函数发送的任何焦点事件，它是用来给的是什么引起的组件获得焦点的解释。如果窗口未处于活动状态，则当窗口变为活动状态时，组件将获得焦点。</font></p>
<p><font style="vertical-align: inherit;">首先，将要更改焦点的事件发送到焦点组件（如果有），以告诉它即将失去焦点。然后焦点被改变，一个 focus out 事件被发送到前一个焦点项目，一个 focus in 事件被发送到新项目，告诉它刚刚收到焦点。（如果焦点输入和焦点输出组件相同，则不会发生任何事情。）</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">在嵌入式平台上，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setFocus-1"><font style="vertical-align: inherit;">setFocus</font></a><font style="vertical-align: inherit;"> () 不会导致输入法打开输入面板。如果您希望发生这种情况，您必须自己向组件发送</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::RequestSoftwareInputPanel</font></a><font style="vertical-align: inherit;">事件。</font></p><p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">在嵌入式平台上，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setFocus-1"><font style="vertical-align: inherit;">setFocus</font></a><font style="vertical-align: inherit;"> () 不会导致输入法打开输入面板。如果您希望发生这种情况，您必须自己向组件发送</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::RequestSoftwareInputPanel</font></a><font style="vertical-align: inherit;">事件。</font></p>
<p><font style="vertical-align: inherit;">请注意，如果组件处于隐藏状态，则在显示之前它不会接受焦点。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">如果您在一个函数中调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setFocus-1"><font style="vertical-align: inherit;">setFocus</font></a><font style="vertical-align: inherit;"> ()，而该函数本身可能会从</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusOutEvent"><font style="vertical-align: inherit;">focusOutEvent</font></a><font style="vertical-align: inherit;"> () 或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusInEvent"><font style="vertical-align: inherit;">focusInEvent</font></a><font style="vertical-align: inherit;"> ()调用，您可能会得到无限递归。</font></p>
<p><b>请参考 </b><a href="qwidget.html#focus-prop">hasFocus</a>(), <a href="qwidget.html#clearFocus">clearFocus</a>(), <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>(), <a href="qwidget.html#focusWidget">focusWidget</a>(), <a href="qapplication.html#focusWidget">QApplication::focusWidget</a>(), <a href="qwidget.html#grabKeyboard">grabKeyboard</a>(), <a href="qwidget.html#grabMouse">grabMouse</a>(), <a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/focus.html"><font style="vertical-align: inherit;">Widgets中的键盘焦点</font></a>,
<span lang="zh-cn">和</span><a href="../qtcore/qevent.html#Type-enum">QEvent::RequestSoftwareInputPanel</a><span lang="zh-cn">。</span></p>
<!-- @@@setFocus -->
<!-- $$$setFocus$$$setFocus -->
<h3 class="fn" id="setFocus-1"><a name="setFocus-1"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">setFocus</span>()</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">如果此组件或其父级之一是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isActiveWindow-prop"><font style="vertical-align: inherit;">活动 window ，</font></a><font style="vertical-align: inherit;">则将键盘输入焦点赋予此组件（或其焦点代理）。</font></p>
<!-- @@@setFocus -->
<!-- $$$setFocusProxy[overload1]$$$setFocusProxyQWidget* -->
<h3 class="fn" id="setFocusProxy"><a name="setFocusProxy"></a><span class="type">void</span> QWidget::<span class="name">setFocusProxy</span>(<span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>w</i>)</h3>
<p><font style="vertical-align: inherit;">将组件的焦点代理设置为组件</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">。如果</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">为 0，则该函数将此组件重置为没有焦点代理。</font></p>
<p><font style="vertical-align: inherit;">一些组件可以“拥有焦点”，但会创建一个子组件（例如</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qlineedit.html"><font style="vertical-align: inherit;">QLineEdit</font></a><font style="vertical-align: inherit;">）来实际处理焦点。在这种情况下，组件可以将行编辑设置为它的焦点代理。</font></p>
<p><font style="vertical-align: inherit;">setFocusProxy() 设置组件，当“这个组件”获得它时，它将实际获得焦点。如果有焦点代理，则</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#setFocus-1"><font style="vertical-align: inherit;">setFocus</font></a><font style="vertical-align: inherit;"> () 和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focus-prop"><font style="vertical-align: inherit;">hasFocus</font></a><font style="vertical-align: inherit;"> () 对焦点代理进行操作。</font></p>
<p><b>请参考 </b><a href="qwidget.html#focusProxy">focusProxy</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setFocusProxy -->
<!-- $$$setForegroundRole[overload1]$$$setForegroundRoleQPalette::ColorRole -->
<h3 class="fn" id="setForegroundRole"><a name="setForegroundRole"></a><span class="type">void</span> QWidget::<span class="name">setForegroundRole</span>(<span class="type"><a href="../qtgui/qpalette.html#ColorRole-enum">QPalette::ColorRole</a></span> <i>role</i>)</h3>
<p><font style="vertical-align: inherit;">将组件的前景角色设置为</font><i><font style="vertical-align: inherit;">role</font></i><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">前景角色定义了用于绘制前景的组件</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#palette-prop"><font style="vertical-align: inherit;">调色板</font></a><font style="vertical-align: inherit;">的颜色。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">role<span lang="zh-cn">（</span>角色<span lang="zh-cn">）</span></font></i><font style="vertical-align: inherit;">是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qpalette.html#ColorRole-enum"><font style="vertical-align: inherit;">QPalette::NoRole</font></a><font style="vertical-align: inherit;">，则组件使用与背景角色形成对比的前景角色。</font></p>
<p><font style="vertical-align: inherit;">请注意，样式可以从调色板中自由选择任何颜色。如果使用 setForegroundRole() 没有达到您想要的结果，您可以修改调色板或设置样式表。</font></p>
<p><b>请参考 </b><a href="qwidget.html#foregroundRole">foregroundRole</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#backgroundRole">backgroundRole</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setForegroundRole -->
<!-- $$$setGeometry -->
<h3 class="fn" id="setGeometry-1"><a name="setGeometry-1"></a><span class="type">void</span> QWidget::<span class="name">setGeometry</span>(<span class="type">int</span> <i>x</i>, <span class="type">int</span> <i>y</i>, <span class="type">int</span> <i>w</i>, <span class="type">int</span> <i>h</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">这对应于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#geometry-prop"><font style="vertical-align: inherit;">setGeometry</font></a><font style="vertical-align: inherit;"> ( </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qrect.html"><font style="vertical-align: inherit;">QRect</font></a><font style="vertical-align: inherit;"> ( </font><i><font style="vertical-align: inherit;">x</font></i><font style="vertical-align: inherit;"> , </font><i><font style="vertical-align: inherit;">y</font></i><font style="vertical-align: inherit;"> , </font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;"> , </font><i><font style="vertical-align: inherit;">h</font></i><font style="vertical-align: inherit;"> ))。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#geometry-prop"><font style="vertical-align: inherit;">几何的</font></a><span lang="zh-cn">设置</span><font style="vertical-align: inherit;">函数。</font></p><!-- @@@setGeometry -->
<!-- $$$setGraphicsEffect[overload1]$$$setGraphicsEffectQGraphicsEffect* -->
<h3 class="fn" id="setGraphicsEffect"><a name="setGraphicsEffect"></a><span class="type">void</span> QWidget::<span class="name">setGraphicsEffect</span>(<span class="type"><a href="qgraphicseffect.html">QGraphicsEffect</a></span> *<i>effect</i>)</h3>
<p><font style="vertical-align: inherit;">setGraphicsEffect 函数用于设置组件的图形效果。</font></p>
<p><font style="vertical-align: inherit;">为组件<span lang="zh-cn">设置</span>效果<i>effect</i>。如果这个组件上已经安装了一个效果，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">会在安装新</font><i><font style="vertical-align: inherit;">效果</font></i><font style="vertical-align: inherit;"><span lang="zh-cn">（<i>effect</i>）</span>之前删除现有的<i>效果<span lang="zh-cn">（effect）</span></i>。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">effect</font></i><font style="vertical-align: inherit;">是在不同组件上安装的效果， setGraphicsEffect() 将从组件中删除效果并将其安装在此组件上。</font></p>
<p><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">拥有</font><i><font style="vertical-align: inherit;">effect 的</font></i><font style="vertical-align: inherit;">所有权。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">此函数将对自身及其所有子项应用效果。</font></p><p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">基于 OpenGL 的组件不支持图形效果，例如 QGLWidget、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qopenglwidget.html"><font style="vertical-align: inherit;">QOpenGLWidget</font></a><font style="vertical-align: inherit;">和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtquick/qquickwidget.html"><font style="vertical-align: inherit;">QQuickWidget</font></a><font style="vertical-align: inherit;">。</font></p><p>
	<font style="vertical-align: inherit;">这个函数是在 Qt 4.6 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#graphicsEffect">graphicsEffect</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setGraphicsEffect -->
<!-- $$$setHidden[overload1]$$$setHiddenbool -->
<h3 class="fn" id="setHidden"><a name="setHidden"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">setHidden</span>(<span class="type">bool</span> <i>hidden</i>)</h3>
<p><font style="vertical-align: inherit;">便捷功能，相当于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">setVisible</font></a><span lang="zh-cn">(!</span><i><font style="vertical-align: inherit;">hidden</font></i><span lang="zh-cn">)</span><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#isHidden">isHidden</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setHidden -->
<!-- $$$setLayout[overload1]$$$setLayoutQLayout* -->
<h3 class="fn" id="setLayout"><a name="setLayout"></a><span class="type">void</span> QWidget::<span class="name">setLayout</span>(<span class="type"><a href="qlayout.html">QLayout</a></span> *<i>layout</i>)</h3>
<p><font style="vertical-align: inherit;">将此组件的布局管理器设置为</font><i><font style="vertical-align: inherit;">layout</font></i><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">如果这个组件上已经安装了一个布局管理器，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">不会让你安装另一个。您必须先删除现有的布局管理器（由</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#layout"><font style="vertical-align: inherit;">layout</font></a><font style="vertical-align: inherit;"> ()返回），然后才能使用新布局调用 setLayout()。</font></p>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">layout </font></i>
<font style="vertical-align: inherit;">是不同组件上的布局管理器，则 setLayout() 将重新设置布局的父级并使其成为该组件的布局管理器。</font></p>
<p><span lang="zh-cn">例如：</span></p>
<pre class="cpp">

      <span class="type"><a href="qvboxlayout.html">QVBoxLayout</a></span> <span class="operator">*</span>layout <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qvboxlayout.html">QVBoxLayout</a></span>;
      layout<span class="operator">-</span><span class="operator">&gt;</span>addWidget(formWidget);
      setLayout(layout);

</pre>
<p><font style="vertical-align: inherit;">调用此函数的另一种方法是将此组件传递给布局的构造函数。</font></p>
<p><font style="vertical-align: inherit;">该</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget的</font></a><font style="vertical-align: inherit;">将<span lang="zh-cn">持有不布局器</span>的所有权</font><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#layout">layout</a>() <span lang="zh-cn">和 
</span><a href="layout.html"><span lang="zh-cn">布局管理</span></a><span lang="zh-cn">。</span></p>
<!-- @@@setLayout -->
<!-- $$$setMask[overload1]$$$setMaskconstQBitmap& -->
<h3 class="fn" id="setMask"><a name="setMask"></a><span class="type">void</span> QWidget::<span class="name">setMask</span>(const <span class="type"><a href="../qtgui/qbitmap.html">QBitmap</a></span> &amp;<i>bitmap</i>)</h3>
<p>使得只有位图对应1位的组件的像素是可见的。如果该区域包含组件<a href="qwidget.html#rect-prop">rect</a>()之外的像素，则该区域中的窗口系统组件可能是可见的，也可能是不可见的，这取决于平台。</p>
<p><font style="vertical-align: inherit;">请注意，如果区域特别复杂，这种效果可能会很慢。</font></p>
<p><font style="vertical-align: inherit;">以下代码显示了如何使用带有 Alpha 通道的图像为组件生成遮罩：</font></p>
<pre class="cpp">

      <span class="type"><a href="qlabel.html">QLabel</a></span> topLevelLabel;
      <span class="type"><a href="../qtgui/qpixmap.html">QPixmap</a></span> pixmap(<span class="string">&quot;:/images/tux.png&quot;</span>);
      topLevelLabel<span class="operator">.</span>setPixmap(pixmap);
      topLevelLabel<span class="operator">.</span>setMask(pixmap<span class="operator">.</span>mask());

</pre>
<p><font style="vertical-align: inherit;">
此代码显示的标签使用其包含的图像进行屏蔽，从而渲染出不规则形状的图像被直接绘制到屏幕上。</font></p>
<p><font style="vertical-align: inherit;">屏蔽组件仅在其可见部分接收鼠标事件。</font></p>
<p><b>请参考 </b><a href="qwidget.html#mask">mask</a>(), <a href="qwidget.html#clearMask">clearMask</a>(), <a href="qwidget.html#windowOpacity-prop">windowOpacity</a>(),
<span lang="zh-cn">和 </span>
<a href="qtwidgets-widgets-shapedclock-example.html">时钟案例</a>.</p>
<!-- @@@setMask -->
<!-- $$$setMask$$$setMaskconstQRegion& -->
<h3 class="fn" id="setMask-1"><a name="setMask-1"></a><span class="type">void</span> QWidget::<span class="name">setMask</span>(const <span class="type"><a href="../qtgui/qregion.html">QRegion</a></span> &amp;<i>region</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">仅使重叠</font><i><font style="vertical-align: inherit;">region<span lang="zh-cn">（</span>区域<span lang="zh-cn">）</span></font></i><font style="vertical-align: inherit;">的组件部分可见。如果该区域包含窗口组件</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#rect-prop"><font style="vertical-align: inherit;">rect</font></a><font style="vertical-align: inherit;"> ()之外的像素，则该<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#rect-prop">区域</a>中的窗口系统组件可能可见，也可能不可见，具体取决于平台。</font></p>
<p><font style="vertical-align: inherit;">请注意，如果区域特别复杂，这种效果可能会很慢。</font></p>
<p><b>请参考 </b><a href="qwidget.html#windowOpacity-prop">windowOpacity</a><span lang="zh-cn">。</span></p>
<!-- @@@setMask -->
<!-- $$$setMaximumSize -->
<h3 class="fn" id="setMaximumSize-1"><a name="setMaximumSize-1"></a><span class="type">void</span> QWidget::<span class="name">setMaximumSize</span>(<span class="type">int</span> <i>maxw</i>, <span class="type">int</span> <i>maxh</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">该函数对应于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#maximumSize-prop"><font style="vertical-align: inherit;">setMaximumSize</font></a><font style="vertical-align: inherit;"> ( </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qsize.html"><font style="vertical-align: inherit;">QSize</font></a><font style="vertical-align: inherit;"> ( </font><i><font style="vertical-align: inherit;">maxw</font></i><font style="vertical-align: inherit;"> , </font><i><font style="vertical-align: inherit;">maxh</font></i><font style="vertical-align: inherit;"> ))。将最大宽度设置为</font><i><font style="vertical-align: inherit;">maxw</font></i><font style="vertical-align: inherit;">，将最大高度设置为</font><i><font style="vertical-align: inherit;">maxh</font></i><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#maximumSize-prop"><font style="vertical-align: inherit;">maximumSize 的</font></a><span lang="zh-cn">设置</span><font style="vertical-align: inherit;">函数。</font></p><!-- @@@setMaximumSize -->
<!-- $$$setMinimumSize -->
<h3 class="fn" id="setMinimumSize-1"><a name="setMinimumSize-1"></a><span class="type">void</span> QWidget::<span class="name">setMinimumSize</span>(<span class="type">int</span> <i>minw</i>, <span class="type">int</span> <i>minh</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">该函数对应于</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">setMinimumSize</font></a><font style="vertical-align: inherit;"> ( </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qsize.html"><font style="vertical-align: inherit;">QSize</font></a><font style="vertical-align: inherit;"> (minw, minh))。将最小宽度设置为</font><i><font style="vertical-align: inherit;">minw</font></i><font style="vertical-align: inherit;">，将最小高度设置为</font><i><font style="vertical-align: inherit;">minh</font></i><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#minimumSize-prop"><font style="vertical-align: inherit;">minimumSize 的</font></a><span lang="zh-cn">设置</span><font style="vertical-align: inherit;">函数。</font></p><!-- @@@setMinimumSize -->
<!-- $$$setParent[overload1]$$$setParentQWidget* -->
<h3 class="fn" id="setParent"><a name="setParent"></a><span class="type">void</span> QWidget::<span class="name">setParent</span>(<span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>parent</i>)</h3>
<p><font style="vertical-align: inherit;">将组件的父级设置为</font><i><font style="vertical-align: inherit;">parent</font></i><font style="vertical-align: inherit;">，并重置窗口标志。组件移动到其新父级中的位置 (0, 0)。</font></p>
<p><font style="vertical-align: inherit;">如果新的父窗口组件位于不同的窗口中，则重新设置父窗口的窗口组件及其子窗口会按照与以前相同的内部顺序附加到新父窗口组件的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#focusPolicy-prop"><font style="vertical-align: inherit;">选项卡链</font></a><font style="vertical-align: inherit;">的末尾。如果移动的组件之一具有键盘焦点，则 setParent()为该组件调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#clearFocus"><font style="vertical-align: inherit;">clearFocus</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><font style="vertical-align: inherit;">如果新的父组件与旧的父组件在同一窗口中，则设置父组件不会更改 Tab 键顺序或键盘焦点。</font></p>
<p><font style="vertical-align: inherit;">如果“新”父组件是旧的父组件，则此函数不执行任何操作。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">作为更改其父级的一部分，组件变得不可见，即使它以前是可见的。您必须调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">show</font></a><font style="vertical-align: inherit;"> () 使组件再次可见。</font></p><p><b>Warning:</b> It is very unlikely that you will ever need this function. If you have a widget that changes its content dynamically, it is far easier to use <a href="qstackedwidget.html">QStackedWidget</a>.</p>
<p><b>请参考 </b><a href="qwidget.html#windowFlags-prop">setWindowFlags</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setParent -->
<!-- $$$setParent$$$setParentQWidget*Qt::WindowFlags -->
<h3 class="fn" id="setParent-1"><a name="setParent-1"></a><span class="type">void</span> QWidget::<span class="name">setParent</span>(<span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>parent</i>, <span class="type"><a href="../qtcore/qt.html#WindowType-enum">Qt::WindowFlags</a></span> <i>f</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">此函数还采用组件标志</font><i><font style="vertical-align: inherit;">f</font></i><font style="vertical-align: inherit;">作为参数。</font></p>
<!-- @@@setParent -->
<!-- $$$setShortcutAutoRepeat[overload1]$$$setShortcutAutoRepeatintbool -->
<h3 class="fn" id="setShortcutAutoRepeat"><a name="setShortcutAutoRepeat"></a><span class="type">void</span> QWidget::<span class="name">setShortcutAutoRepeat</span>(<span class="type">int</span> <i>id</i>, <span class="type">bool</span> <i>enable</i> = true)</h3>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">enable</font></i><font style="vertical-align: inherit;">为 true，则启用具有给定</font><i><font style="vertical-align: inherit;">id</font></i><font style="vertical-align: inherit;">的快捷方式的自动重复；否则它被禁用。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.2 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#grabShortcut">grabShortcut</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#releaseShortcut">releaseShortcut</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setShortcutAutoRepeat -->
<!-- $$$setShortcutEnabled[overload1]$$$setShortcutEnabledintbool -->
<h3 class="fn" id="setShortcutEnabled"><a name="setShortcutEnabled"></a><span class="type">void</span> QWidget::<span class="name">setShortcutEnabled</span>(<span class="type">int</span> <i>id</i>, <span class="type">bool</span> <i>enable</i> = true)</h3>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">enable</font></i><font style="vertical-align: inherit;">为 true，则启用具有给定</font><i><font style="vertical-align: inherit;">id</font></i><font style="vertical-align: inherit;">的快捷方式；否则快捷方式将被禁用。</font></p>
<p><b><font style="vertical-align: inherit;"><span lang="zh-cn">警</span>告：</font></b><font style="vertical-align: inherit;">您通常不需要使用此功能，因为 Qt 的快捷方式系统会在组件隐藏/可见以及获得或失去焦点时自动启用/禁用快捷方式。最好使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qaction.html"><font style="vertical-align: inherit;">QAction</font></a><font style="vertical-align: inherit;">或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qshortcut.html"><font style="vertical-align: inherit;">QShortcut</font></a><font style="vertical-align: inherit;">来处理快捷方式，因为它们比这个低级函数更容易使用。</font></p>
<p><b>请参考 </b><a href="qwidget.html#grabShortcut">grabShortcut</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#releaseShortcut">releaseShortcut</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setShortcutEnabled -->
<!-- $$$setSizeIncrement -->
<h3 class="fn" id="setSizeIncrement-1"><a name="setSizeIncrement-1"></a><span class="type">void</span> QWidget::<span class="name">setSizeIncrement</span>(<span class="type">int</span> <i>w</i>, <span class="type">int</span> <i>h</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">将 x（宽度）大小增量设置为</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">，将 y（高度）大小增量设置为</font><i><font style="vertical-align: inherit;">h</font></i><font style="vertical-align: inherit;">。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeIncrement-prop"><font style="vertical-align: inherit;">sizeIncrement 的</font></a><span lang="zh-cn">设置</span><font style="vertical-align: inherit;">函数。</font></p><!-- @@@setSizeIncrement -->
<!-- $$$setSizePolicy -->
<h3 class="fn" id="setSizePolicy-1"><a name="setSizePolicy-1"></a><span class="type">void</span> QWidget::<span class="name">setSizePolicy</span>(<span class="type"><a href="qsizepolicy.html#Policy-enum">QSizePolicy::Policy</a></span> <i>horizontal</i>, <span class="type"><a href="qsizepolicy.html#Policy-enum">QSizePolicy::Policy</a></span> <i>vertical</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">将组件的大小策略设置为<i>horizontal</i>和<i>vertical</i>，具有标准拉伸并且没有高度换宽度。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizePolicy-prop"><font style="vertical-align: inherit;">sizePolicy 的</font></a><span lang="zh-cn">设置</span><font style="vertical-align: inherit;">函数。</font></p><p><b>请参考 </b><a href="qsizepolicy.html#QSizePolicy">QSizePolicy::QSizePolicy</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setSizePolicy -->
<!-- $$$setStyle[overload1]$$$setStyleQStyle* -->
<h3 class="fn" id="setStyle"><a name="setStyle"></a><span class="type">void</span> QWidget::<span class="name">setStyle</span>(<span class="type"><a href="qstyle.html">QStyle</a></span> *<i>style</i>)</h3>
<p><font style="vertical-align: inherit;">将组件的 GUI 样式设置为</font><i><font style="vertical-align: inherit;">style</font></i><font style="vertical-align: inherit;">。样式对象的所有权不会转移。</font></p>
<p><font style="vertical-align: inherit;">如果没有设置样式，组件将使用应用程序的样式</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qapplication.html#style"><font style="vertical-align: inherit;">QApplication::style</font></a><font style="vertical-align: inherit;"> () 代替。</font></p>
<p><font style="vertical-align: inherit;">置组件的样式对现有或未来的子组件没有影响。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">此函数对于演示目的特别有用，您希望在其中展示 Qt 的样式功能。真正的应用程序应该避免它并使用一种一致的 GUI 样式来代替。</font></p>
<p><b><font style="vertical-align: inherit;">警告：</font></b><font style="vertical-align: inherit;">自定义</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qstyle.html"><font style="vertical-align: inherit;">QStyle</font></a><font style="vertical-align: inherit;">子类当前不支持 Qt 样式表。我们计划在未来的某个版本中解决这个问题。</font></p>
<p><b>请参考 </b><a href="qwidget.html#style">style</a>(), <a href="qstyle.html">QStyle</a>, <a href="qapplication.html#style">QApplication::style</a>(),
<span lang="zh-cn">和 </span><a href="qapplication.html#setStyle">QApplication::setStyle</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setStyle -->
<!-- $$$setTabOrder[overload1]$$$setTabOrderQWidget*QWidget* -->
<h3 class="fn" id="setTabOrder"><a name="setTabOrder"></a><code>[static] </code><span class="type">void</span> QWidget::<span class="name">setTabOrder</span>(<span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>first</i>, <span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>second</i>)</h3>
<p><span lang="zh-cn">将</span><i><font style="vertical-align: inherit;"><span lang="zh-cn">second（第二）个组件放在first（第一个）组件聚焦顺序之后。</span></font></i></p>
<p><font style="vertical-align: inherit;">它有效地从其焦点链中删除了</font><i><font style="vertical-align: inherit;">第二</font></i><font style="vertical-align: inherit;">个组件，并将其插入到</font><i><font style="vertical-align: inherit;">第一</font></i><font style="vertical-align: inherit;">个组件之后。</font></p>
<p><font style="vertical-align: inherit;">请注意，由于</font><i><font style="vertical-align: inherit;">第二</font></i><font style="vertical-align: inherit;">个组件的 Tab 键顺序已更改，因此您应该订购这样的链：</font></p>
<pre class="cpp">

  setTabOrder(a<span class="operator">,</span> b); <span class="comment">// a to b</span>
  setTabOrder(b<span class="operator">,</span> c); <span class="comment">// a to b to c</span>
  setTabOrder(c<span class="operator">,</span> d); <span class="comment">// a to b to c to d</span>

</pre>
<p><i><font style="vertical-align: inherit;">不是</font></i><font style="vertical-align: inherit;">这样：</font></p>
<pre class="cpp">

  <span class="comment">// WRONG</span>
  setTabOrder(c<span class="operator">,</span> d); <span class="comment">// c to d</span>
  setTabOrder(a<span class="operator">,</span> b); <span class="comment">// a to b AND c to d</span>
  setTabOrder(b<span class="operator">,</span> c); <span class="comment">// a to b to c, but not c to d</span>

</pre>
<p><font style="vertical-align: inherit;">如果</font><i><font style="vertical-align: inherit;">第一个</font></i><font style="vertical-align: inherit;">或</font><i><font style="vertical-align: inherit;">第二个</font></i><font style="vertical-align: inherit;">具有焦点代理，则 setTabOrder() 会正确替换该代理。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">从 Qt 5.10 开始：具有子代作为焦点代理的组件被理解为复合组件。在一个或两个复合组件之间设置 Tab 键顺序时，将保留每个内部的本地 Tab 键顺序。这意味着如果两个组件都是复合组件，则生成的 Tab 键顺序将从</font><i><font style="vertical-align: inherit;">first 中</font></i><font style="vertical-align: inherit;">的最后一个子级到</font><i><font style="vertical-align: inherit;">second 中</font></i><font style="vertical-align: inherit;">的第一个子级。</font></p><p><b>请参考 </b><a href="qwidget.html#focusPolicy-prop">setFocusPolicy</a>(), <a href="qwidget.html#setFocusProxy">setFocusProxy</a>(),
	<span lang="zh-cn">和 </span><a href="focus.html"><span lang="zh-cn">组件中的键盘焦点</span></a><span lang="zh-cn">。</span></p>
<!-- @@@setTabOrder -->
<!-- $$$setWindowFlag[overload1]$$$setWindowFlagQt::WindowTypebool -->
<h3 class="fn" id="setWindowFlag"><a name="setWindowFlag"></a><span class="type">void</span> QWidget::<span class="name">setWindowFlag</span>(<span class="type"><a href="../qtcore/qt.html#WindowType-enum">Qt::WindowType</a></span> <i>flag</i>, <span class="type">bool</span> <i>on</i> = true)</h3>
<p>S<font style="vertical-align: inherit;">如果<i>on</i>为真，则<i>在</i>此组件<i>上</i>设置窗口标志</font><i><font style="vertical-align: inherit;">flag</font></i><font style="vertical-align: inherit;">；否则清除标志。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 5.9 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#windowFlags-prop">setWindowFlags</a>(), <a href="qwidget.html#windowFlags-prop">windowFlags</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#windowType">windowType</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setWindowFlag -->
<!-- $$$setWindowRole[overload1]$$$setWindowRoleconstQString& -->
<h3 class="fn" id="setWindowRole"><a name="setWindowRole"></a><span class="type">void</span> QWidget::<span class="name">setWindowRole</span>(const <span class="type"><a href="../qtcore/qstring.html">QString</a></span> &amp;<i>role</i>)</h3>
<p><font style="vertical-align: inherit;">将窗口的角色设置为</font><i><font style="vertical-align: inherit;">role</font></i><font style="vertical-align: inherit;">。这仅对 X11 上的  
<span lang="zh-cn">窗口</span>有意义。</font></p>
<p><b>请参考 </b><a href="qwidget.html#windowRole">windowRole</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setWindowRole -->
<!-- $$$setWindowState[overload1]$$$setWindowStateQt::WindowStates -->
<h3 class="fn" id="setWindowState"><a name="setWindowState"></a><span class="type">void</span> QWidget::<span class="name">setWindowState</span>(<span class="type"><a href="../qtcore/qt.html#WindowState-enum">Qt::WindowStates</a></span> <i>windowState</i>)</h3>
<p><font style="vertical-align: inherit;">窗口状态是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum"><font style="vertical-align: inherit;">Qt::WindowState</font></a><span lang="zh-cn">（<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum"><font style="vertical-align: inherit;">Qt::WindowMinimized</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum"><font style="vertical-align: inherit;">Qt::WindowMaximized</font></a><font style="vertical-align: inherit;">、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum"><font style="vertical-align: inherit;">Qt::WindowFullScreen</font></a><font style="vertical-align: inherit;">和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum"><font style="vertical-align: inherit;">Qt::WindowActive</font></a></span><font style="vertical-align: inherit;"><span lang="zh-cn">）</span>的 OR 组合。</font></p>
<p><font style="vertical-align: inherit;">如果窗口不可见（即</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">isVisible</font></a><font style="vertical-align: inherit;"> () 返回</font><code>false</code><font style="vertical-align: inherit;">），则调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">show</font></a><font style="vertical-align: inherit;"> ()时窗口状态生效。对于可见窗口，更改是即时的。例如，要在全屏和普通模式之间切换，请使用以下代码：</font></p>
<pre class="cpp">

  w<span class="operator">-</span><span class="operator">&gt;</span>setWindowState(w<span class="operator">-</span><span class="operator">&gt;</span>windowState() <span class="operator">^</span> <span class="type">Qt</span><span class="operator">::</span>WindowFullScreen);

</pre>
<p><font style="vertical-align: inherit;">为了恢复和激活最小化的窗口（同时保留其最大化和/或全屏状态），请使用以下命令：</font></p>
<pre class="cpp">

  w<span class="operator">-</span><span class="operator">&gt;</span>setWindowState((w<span class="operator">-</span><span class="operator">&gt;</span>windowState() <span class="operator">&amp;</span> <span class="operator">~</span><span class="type">Qt</span><span class="operator">::</span>WindowMinimized) <span class="operator">|</span> <span class="type">Qt</span><span class="operator">::</span>WindowActive);

</pre>
<p><font style="vertical-align: inherit;">调用此函数将隐藏组件。您必须调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#show"><font style="vertical-align: inherit;">show</font></a><font style="vertical-align: inherit;"> () 使组件再次可见。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">在某些窗口系统上，</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum"><font style="vertical-align: inherit;">Qt::WindowActive</font></a><font style="vertical-align: inherit;">不是即时的，在某些情况下可能会被忽略。</font></p><p><font style="vertical-align: inherit;">当窗口状态改变时，组件会收到一个<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum">QEvent::WindowStateChange</a>类型的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#changeEvent"><font style="vertical-align: inherit;">changeEvent</font></a><font style="vertical-align: inherit;"> () 。</font></p>
<p><b>请参考 </b><a href="../qtcore/qt.html#WindowState-enum">Qt::WindowState</a> 
<span lang="zh-cn">和 </span><a href="qwidget.html#windowState">windowState</a>()<span lang="zh-cn">。</span></p>
<!-- @@@setWindowState -->
<!-- $$$setupUi[overload1]$$$setupUiQWidget* -->
<h3 class="fn" id="setupUi"><a name="setupUi"></a><span class="type">void</span> QWidget::<span class="name">setupUi</span>(<span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>widget</i>)</h3>
<p><font style="vertical-align: inherit;">为指定的</font><i><font style="vertical-align: inherit;">组件</font></i><font style="vertical-align: inherit;"><i>widget</i>设置用户界面。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">此功能可用于从使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtdoc/uic.html"><font style="vertical-align: inherit;">uic</font></a><font style="vertical-align: inherit;">创建的用户界面描述派生的组件。</font></p><p><b>请参考 <a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtdesigner/designer-using-a-ui-file.html"><font style="vertical-align: inherit;">在您的应用程序中使用设计器 UI 文件</font></a><span lang="zh-cn">。</span></b></p>
<!-- @@@setupUi -->
<!-- $$$show[overload1]$$$show -->
<h3 class="fn" id="show"><a name="show"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">show</span>()</h3>
<p><font style="vertical-align: inherit;">显示组件及其子组件。</font></p>
<p><font style="vertical-align: inherit;">这相当于调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#showFullScreen"><font style="vertical-align: inherit;">showFullScreen</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#showMaximized"><font style="vertical-align: inherit;">showMaximized</font></a><font style="vertical-align: inherit;"> () 或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">setVisible</font></a><font style="vertical-align: inherit;"> (true)，具体取决于平台对窗口标志的默认行为。</font></p>
<p><b><font style="vertical-align: inherit;">请参考</font></b><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#raise"><font style="vertical-align: inherit;">raise</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#showEvent"><font style="vertical-align: inherit;">showEvent</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#hide"><font style="vertical-align: inherit;">hide</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">setVisible</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#showMinimized"><font style="vertical-align: inherit;">showMinimized</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#showMaximized"><font style="vertical-align: inherit;">showMaximized</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#showNormal"><font style="vertical-align: inherit;">showNormal</font></a><font style="vertical-align: inherit;"> ()、</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#visible-prop"><font style="vertical-align: inherit;">isVisible</font></a><font style="vertical-align: inherit;"> ()和</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#windowFlags-prop"><font style="vertical-align: inherit;">windowFlags</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<!-- @@@show -->
<!-- $$$showEvent[overload1]$$$showEventQShowEvent* -->
<h3 class="fn" id="showEvent"><a name="showEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">showEvent</span>(<span class="type"><a href="../qtgui/qshowevent.html">QShowEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">此事件处理程序可以在子类中重新实现，以接收在</font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">参数中传递的组件显示事件。</font></p>
<p>非自发的显示事件在显示之前立即发送到组件。自发的窗口展示事件是随后交付的。</p>
<p>
注意:当窗口系统改变窗口的映射状态时，窗口组件会收到自发的显示和隐藏事件，例如，当用户最小化窗口时，会收到自发的隐藏事件，当窗口再次恢复时，会收到自发的显示事件。在接收到自发的隐藏事件后，组件仍然被认为是可见的，即<a href="qwidget.html#visible-prop">isVisible</a>()。</p>
<p><b>请参考 </b><a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#event">event</a>(),
<span lang="zh-cn">和 </span><a href="../qtgui/qshowevent.html">QShowEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@showEvent -->
<!-- $$$showFullScreen[overload1]$$$showFullScreen -->
<h3 class="fn" id="showFullScreen"><a name="showFullScreen"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">showFullScreen</span>()</h3>
<p><font style="vertical-align: inherit;">以全屏模式显示组件。</font></p>
<p><font style="vertical-align: inherit;">调用这个函数只影响</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isWindow"><font style="vertical-align: inherit;"><span lang="zh-cn">窗口</span></font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">要从全屏模式返回，请调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#showNormal"><font style="vertical-align: inherit;">showNormal</font></a><font style="vertical-align: inherit;"> ()。</font></p>
<p><font style="vertical-align: inherit;">全屏模式在 Windows 下工作正常，但在 X系统 下有一些问题。这些问题是由于指定 X11 客户端和窗口管理器之间通信的 ICCCM 协议的限制。ICCCM 根本不理解非装饰全屏窗口的概念。因此，我们能做的最好的事情就是请求一个无边框窗口并放置并调整其大小以填充整个屏幕。根据窗口管理器的不同，这可能有效，也可能无效。使用 MOTIF 提示请求无边框窗口，几乎所有现代窗口管理器至少部分支持这些提示。</font></p>
<p><font style="vertical-align: inherit;">另一种方法是完全绕过窗口管理器并使用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::X11BypassWindowManagerHint</font></a><font style="vertical-align: inherit;">标志创建一个窗口。但是，这还有其他严重的问题，例如完全损坏的键盘焦点以及对桌面更改或用户提升其他窗口时的非常奇怪的影响。</font></p>
<p><font style="vertical-align: inherit;">遵循现代后 ICCCM 规范的 X11 窗口管理器正确支持全屏模式。</font></p>
<p><b>请参考 </b><a href="qwidget.html#showNormal">showNormal</a>(), <a href="qwidget.html#showMaximized">showMaximized</a>(), <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#visible-prop">isVisible</a>()<span lang="zh-cn">。</span></p>
<!-- @@@showFullScreen -->
<!-- $$$showMaximized[overload1]$$$showMaximized -->
<h3 class="fn" id="showMaximized"><a name="showMaximized"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">showMaximized</span>()</h3>
<p><font style="vertical-align: inherit;">显示最大化的组件。</font></p>
<p><font style="vertical-align: inherit;">调用这个函数只影响</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isWindow"><font style="vertical-align: inherit;">windows</font></a><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">在 X11 上，此功能可能无法与某些窗口管理器一起正常工作。有关解释，请参阅</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/application-windows.html#window-geometry"><font style="vertical-align: inherit;">窗口几何</font></a><font style="vertical-align: inherit;">文档。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setWindowState">setWindowState</a>(), <a href="qwidget.html#showNormal">showNormal</a>(), <a href="qwidget.html#showMinimized">showMinimized</a>(), <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#visible-prop">isVisible</a>()<span lang="zh-cn">。</span></p>
<!-- @@@showMaximized -->
<!-- $$$showMinimized[overload1]$$$showMinimized -->
<h3 class="fn" id="showMinimized"><a name="showMinimized"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">showMinimized</span>()</h3>
<p><font style="vertical-align: inherit;">将最小化的组件显示为图标。</font></p>
<p><font style="vertical-align: inherit;">调用这个函数只影响</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isWindow"><font style="vertical-align: inherit;"><span lang="zh-cn">窗口</span></font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#showNormal">showNormal</a>(), <a href="qwidget.html#showMaximized">showMaximized</a>(), <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#visible-prop">isVisible</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#minimized-prop">isMinimized</a>()<span lang="zh-cn">。</span></p>
<!-- @@@showMinimized -->
<!-- $$$showNormal[overload1]$$$showNormal -->
<h3 class="fn" id="showNormal"><a name="showNormal"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">showNormal</span>()</h3>
<p><font style="vertical-align: inherit;">在最大化或最小化后恢复组件。</font></p>
<p><font style="vertical-align: inherit;">调用这个函数只影响</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#isWindow"><font style="vertical-align: inherit;"><span lang="zh-cn">窗口</span></font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setWindowState">setWindowState</a>(), <a href="qwidget.html#showMinimized">showMinimized</a>(), <a href="qwidget.html#showMaximized">showMaximized</a>(), <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(),
<span lang="zh-cn">和 </span><a href="qwidget.html#visible-prop">isVisible</a>()<span lang="zh-cn">。</span></p>
<!-- @@@showNormal -->
<!-- $$$stackUnder[overload1]$$$stackUnderQWidget* -->
<h3 class="fn" id="stackUnder"><a name="stackUnder"></a><span class="type">void</span> QWidget::<span class="name">stackUnder</span>(<span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *<i>w</i>)</h3>
<p><font style="vertical-align: inherit;">将组件放在父组件堆栈中的</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">下。</font></p>
<p><font style="vertical-align: inherit;">为了完成这项工作，组件本身和</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">必须是兄弟姐妹。</font></p>
<p><b>请参考 </b><a href="qwidget.html#raise">raise</a>() <span lang="zh-cn">和 
</span><a href="qwidget.html#lower">lower</a>()<span lang="zh-cn">。</span></p>
<!-- @@@stackUnder -->
<!-- $$$style[overload1]$$$style -->
<h3 class="fn" id="style"><a name="style"></a><span class="type"><a href="qstyle.html">QStyle</a></span> *QWidget::<span class="name">style</span>() const</h3>
<p><b>请参考 </b><a href="qwidget.html#setStyle">QWidget::setStyle</a>(), <a href="qapplication.html#setStyle">QApplication::setStyle</a>(),
<span lang="zh-cn">和 </span><a href="qapplication.html#style">QApplication::style</a>()<span lang="zh-cn">。</span></p>
<!-- @@@style -->
<!-- $$$tabletEvent[overload1]$$$tabletEventQTabletEvent* -->
<h3 class="fn" id="tabletEvent"><a name="tabletEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">tabletEvent</span>(<span class="type"><a href="../qtgui/qtabletevent.html">QTabletEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于 <span lang="zh-cn">平板电脑时间</span></font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现，以接收组件的平板电脑事件。</font></p>
<p><font style="vertical-align: inherit;">如果你重新实现这个处理程序，如果你不处理它，<a href="../qtcore/qevent.html">ignore()</a>事件是非常重要的，这样组件的父级可以解释它。</font></p>
<p><font style="vertical-align: inherit;">默认实现忽略该事件。</font></p>
<p><font style="vertical-align: inherit;">如果平板电脑跟踪关闭，则平板电脑移动事件仅在触控笔与平板电脑接触或在移动触控笔时按下至少一个触控笔按钮时才会发生。如果平板电脑跟踪打开，即使手写笔悬停在平板电脑附近，没有按下任何按钮，也会发生平板电脑移动事件。</font></p>
<p><b>请参考 </b><a href="../qtcore/qevent.html#ignore">QEvent::ignore</a>(), <a href="../qtcore/qevent.html#accept">QEvent::accept</a>(), <a href="qwidget.html#event">event</a>(), <a href="qwidget.html#tabletTracking-prop">setTabletTracking</a>(),
<span lang="zh-cn">和 </span><a href="../qtgui/qtabletevent.html">QTabletEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@tabletEvent -->
<!-- $$$testAttribute[overload1]$$$testAttributeQt::WidgetAttribute -->
<h3 class="fn" id="testAttribute"><a name="testAttribute"></a><span class="type">bool</span> QWidget::<span class="name">testAttribute</span>(<span class="type"><a href="../qtcore/qt.html#WidgetAttribute-enum">Qt::WidgetAttribute</a></span> <i>attribute</i>) const</h3>
<p><span lang="zh-cn">如果</span><font style="vertical-align: inherit;">在此组件上设置了属性</font><i><font style="vertical-align: inherit;">attribute返回<code>true</code></font></i><font style="vertical-align: inherit;">；否则返回</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setAttribute">setAttribute</a>()<span lang="zh-cn">。</span></p>
<!-- @@@testAttribute -->
<!-- $$$underMouse[overload1]$$$underMouse -->
<h3 class="fn" id="underMouse"><a name="underMouse"></a><span class="type">bool</span> QWidget::<span class="name">underMouse</span>() const</h3>
<p><font style="vertical-align: inherit;"><span lang="zh-cn">如果</span>组件在鼠标光标下返回<code>true</code>；否则返回</font><code>false</code><font style="vertical-align: inherit;">。</font></p>
<p><font style="vertical-align: inherit;">此值在拖放操作期间未正确更新。</font></p>
<p><b>请参考 </b><a href="qwidget.html#enterEvent">enterEvent</a>()
<span lang="zh-cn">和 </span><a href="qwidget.html#leaveEvent">leaveEvent</a>()<span lang="zh-cn">。</span></p>
<!-- @@@underMouse -->
<!-- $$$ungrabGesture[overload1]$$$ungrabGestureQt::GestureType -->
<h3 class="fn" id="ungrabGesture"><a name="ungrabGesture"></a><span class="type">void</span> QWidget::<span class="name">ungrabGesture</span>(<span class="type"><a href="../qtcore/qt.html#GestureType-enum">Qt::GestureType</a></span> <i>gesture</i>)</h3>
<p><font style="vertical-align: inherit;">从给定的</font><i><font style="vertical-align: inherit;">gesture<span lang="zh-cn">（</span>手势</font></i><font style="vertical-align: inherit;"><span lang="zh-cn">）</span>类型取消订阅组件<span lang="zh-cn">。</span></font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 4.6 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#grabGesture">grabGesture</a>()
<span lang="zh-cn">和 </span><a href="qgestureevent.html">QGestureEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@ungrabGesture -->
<!-- $$$update[overload1]$$$update -->
<h3 class="fn" id="update"><a name="update"></a><code>[slot] </code><span class="type">void</span> QWidget::<span class="name">update</span>()</h3>
<p><font style="vertical-align: inherit;">除非禁用更新或隐藏组件，否则更新组件。</font></p>
<p><font style="vertical-align: inherit;">此函数不会立即重新绘制；相反，它会在 Qt 返回到主事件循环时安排一个绘制事件进行处理。与调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#repaint"><font style="vertical-align: inherit;">repaint</font></a><font style="vertical-align: inherit;"> ()相比，这允许 Qt 进行优化以获得更高的速度和更少的闪烁。</font></p>
<p><font style="vertical-align: inherit;">多次调用 update() 通常只会导致一次</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#paintEvent"><font style="vertical-align: inherit;">paintEvent</font></a><font style="vertical-align: inherit;"> () 调用。</font></p>
<p><font style="vertical-align: inherit;">Qt 通常在</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#paintEvent"><font style="vertical-align: inherit;">paintEvent</font></a><font style="vertical-align: inherit;"> () 调用之前擦除组件的区域。如果设置了</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WidgetAttribute-enum"><font style="vertical-align: inherit;">Qt::WA_OpaquePaintEvent</font></a><font style="vertical-align: inherit;">组件属性，则组件负责用不透明颜色绘制其所有像素。</font></p>
<p><b>请参考 </b><a href="qwidget.html#repaint">repaint</a>(), <a href="qwidget.html#paintEvent">paintEvent</a>(), <a href="qwidget.html#updatesEnabled-prop">setUpdatesEnabled</a>(),
<span lang="zh-cn">和 </span>
<a href="qtwidgets-widgets-analogclock-example.html"><span lang="zh-cn">模拟时钟案例</span></a><span lang="zh-cn">。</span></p>
<!-- @@@update -->
<!-- $$$update$$$updateintintintint -->
<h3 class="fn" id="update-1"><a name="update-1"></a><span class="type">void</span> QWidget::<span class="name">update</span>(<span class="type">int</span> <i>x</i>, <span class="type">int</span> <i>y</i>, <span class="type">int</span> <i>w</i>, <span class="type">int</span> <i>h</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">此版本更新组件内的矩形<span lang="zh-cn">区域</span>（</font><i><font style="vertical-align: inherit;">x</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">y</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">w</font></i><font style="vertical-align: inherit;">、</font><i><font style="vertical-align: inherit;">h</font></i><font style="vertical-align: inherit;">）。</font></p>
<!-- @@@update -->
<!-- $$$update$$$updateconstQRect& -->
<h3 class="fn" id="update-2"><a name="update-2"></a><span class="type">void</span> QWidget::<span class="name">update</span>(const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span> &amp;<i>rect</i>)</h3>
<p>这是一个重载函数。</p>
<p><font style="vertical-align: inherit;">此版本更新组件内的矩形<span lang="zh-cn">区域</span></font><i><font style="vertical-align: inherit;">rect</font></i><font style="vertical-align: inherit;">。</font></p>
<!-- @@@update -->
<!-- $$$update$$$updateconstQRegion& -->
<h3 class="fn" id="update-3"><a name="update-3"></a><span class="type">void</span> QWidget::<span class="name">update</span>(const <span class="type"><a href="../qtgui/qregion.html">QRegion</a></span> &amp;<i>rgn</i>)</h3>
<p>这是一个重载函数。</p>
<p>此版本在组件内重新绘制区域rgn。</p>
<!-- @@@update -->
<!-- $$$updateGeometry[overload1]$$$updateGeometry -->
<h3 class="fn" id="updateGeometry"><a name="updateGeometry"></a><span class="type">void</span> QWidget::<span class="name">updateGeometry</span>()</h3>
<p><font style="vertical-align: inherit;">通知布局系统此组件已更改并且可能需要更改几何图形。</font></p>
<p><font style="vertical-align: inherit;">如果</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizeHint-prop"><font style="vertical-align: inherit;">sizeHint</font></a><font style="vertical-align: inherit;"> () 或</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#sizePolicy-prop"><font style="vertical-align: inherit;">sizePolicy</font></a><font style="vertical-align: inherit;"> () 已更改，则调用此函数。</font></p>
<p><font style="vertical-align: inherit;">对于显式隐藏的组件，updateGeometry() 是空操作。显示组件后将立即通知布局系统。</font></p>
<!-- @@@updateGeometry -->
<!-- $$$updateMicroFocus[overload1]$$$updateMicroFocus -->
<h3 class="fn" id="updateMicroFocus"><a name="updateMicroFocus"></a><code>[protected slot] </code><span class="type">void</span> QWidget::<span class="name">updateMicroFocus</span>()</h3>
<p><font style="vertical-align: inherit;">更新组件的微焦点。</font></p>
<!-- @@@updateMicroFocus -->
<!-- $$$visibleRegion[overload1]$$$visibleRegion -->
<h3 class="fn" id="visibleRegion"><a name="visibleRegion"></a><span class="type"><a href="../qtgui/qregion.html">QRegion</a></span> QWidget::<span class="name">visibleRegion</span>() const</h3>
<p><font style="vertical-align: inherit;">返回可能发生绘制事件的未遮挡区域。</font></p>
<p><font style="vertical-align: inherit;">对于可见组件，这是其他组件未覆盖的区域的近似值；否则，这是一个空区域。</font></p>
<p><font style="vertical-align: inherit;"><a href="qwidget.html#repaint">repaint</a><span lang="zh-cn">()</span>函数调用（如有必要）这个函数，所以一般你不需要调用它。</font></p>
<!-- @@@visibleRegion -->
<!-- $$$wheelEvent[overload1]$$$wheelEventQWheelEvent* -->
<h3 class="fn" id="wheelEvent"><a name="wheelEvent"></a><code>[virtual protected] </code><span class="type">void</span> QWidget::<span class="name">wheelEvent</span>(<span class="type"><a href="../qtgui/qwheelevent.html">QWheelEvent</a></span> *<i>event</i>)</h3>
<p><font style="vertical-align: inherit;">这个事件处理程序，用于<span lang="zh-cn">滚轮</span>事件 </font><i><font style="vertical-align: inherit;">event</font></i><font style="vertical-align: inherit;">，可以在子类中重新实现，以接收组件的<span lang="zh-cn">滚轮</span>事件。</font></p>
<p><font style="vertical-align: inherit;">如果你重新实现这个处理程序，如果你不处理它，<span lang="zh-cn">调用</span><a href="../qtcore/qevent.html">ignore()</a><span lang="zh-cn">忽略</span>事件是非常重要的，这样组件的父级可以解释它。</font></p>
<p><font style="vertical-align: inherit;">默认实现忽略该事件。</font></p>
<p><b>请参考 </b><a href="../qtcore/qevent.html#ignore">QEvent::ignore</a>(), <a href="../qtcore/qevent.html#accept">QEvent::accept</a>(), <a href="qwidget.html#event">event</a>(),
<span lang="zh-cn">和 </span><a href="../qtgui/qwheelevent.html">QWheelEvent</a><span lang="zh-cn">。</span></p>
<!-- @@@wheelEvent -->
<!-- $$$winId[overload1]$$$winId -->
<h3 class="fn" id="winId"><a name="winId"></a><span class="type">WId</span> QWidget::<span class="name">winId</span>() const</h3>
<p><font style="vertical-align: inherit;">返回组件的窗口系统标识符。</font></p>
<p><font style="vertical-align: inherit;">原则上是可移植的，但如果你使用它，你可能会做一些不可移植的事情。当心。</font></p>
<p><font style="vertical-align: inherit;">如果一个组件是非本地的（外来的）并且在其上调用了 winId()，那么该组件将被提供一个本地句柄。</font></p>
<p><font style="vertical-align: inherit;">此值可能会在运行时更改。在窗口系统标识符发生更改后，将向组件发送类型为</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qevent.html#Type-enum"><font style="vertical-align: inherit;">QEvent::WinIdChange</font></a><font style="vertical-align: inherit;">的事件。</font></p>
<p><b>请参考 </b><a href="qwidget.html#find">find</a>()<span lang="zh-cn">。</span></p>
<!-- @@@winId -->
<!-- $$$window[overload1]$$$window -->
<h3 class="fn" id="window"><a name="window"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QWidget::<span class="name">window</span>() const</h3>
<p><font style="vertical-align: inherit;">返回此组件的窗口，即具有（或可能具有）窗口系统框架的下一个祖先组件。</font></p>
<p><font style="vertical-align: inherit;">如果组件是一个窗口，则返回组件本身。</font></p>
<p><font style="vertical-align: inherit;">典型用法是更改窗口标题：</font></p>
<pre class="cpp">

  aWidget<span class="operator">-</span><span class="operator">&gt;</span>window()<span class="operator">-</span><span class="operator">&gt;</span>setWindowTitle(<span class="string">&quot;New Window Title&quot;</span>);

</pre>
<p><b>请参考 </b><a href="qwidget.html#isWindow">isWindow</a>()<span lang="zh-cn">。</span></p>
<!-- @@@window -->
<!-- $$$windowHandle[overload1]$$$windowHandle -->
<h3 class="fn" id="windowHandle"><a name="windowHandle"></a><span class="type"><a href="../qtgui/qwindow.html">QWindow</a></span> *QWidget::<span class="name">windowHandle</span>() const</h3>
<p><font style="vertical-align: inherit;">如果这是本机组件，则返回关联的</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtgui/qwindow.html"><font style="vertical-align: inherit;">QWindow</font></a><font style="vertical-align: inherit;">。否则返回空值。</font></p>
<p><font style="vertical-align: inherit;">本机组件包括顶级组件、QGLWidget 和调用</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#winId"><font style="vertical-align: inherit;">winId</font></a><font style="vertical-align: inherit;"> () 的子组件。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 5.0 中引入的。</font></p>
<p><b>请参考 </b><a href="qwidget.html#winId">winId</a>()<span lang="zh-cn">。</span></p>
<!-- @@@windowHandle -->
<!-- $$$windowIconChanged -->
<h3 class="fn" id="windowIconChanged"><a name="windowIconChanged"></a><code>[signal] </code><span class="type">void</span> QWidget::<span class="name">windowIconChanged</span>(const <span class="type"><a href="../qtgui/qicon.html">QIcon</a></span> &amp;<i>icon</i>)</h3>
<p><font style="vertical-align: inherit;">当窗口的图标改变时发出这个信号，新</font><i><font style="vertical-align: inherit;">图标</font></i><font style="vertical-align: inherit;">作为参数。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 5.2 中引入的。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#windowIcon-prop"><font style="vertical-align: inherit;">windowIcon 的</font></a><font style="vertical-align: inherit;">通知程序信号。</font></p><!-- @@@windowIconChanged -->
<!-- $$$windowRole[overload1]$$$windowRole -->
<h3 class="fn" id="windowRole"><a name="windowRole"></a><span class="type"><a href="../qtcore/qstring.html">QString</a></span> QWidget::<span class="name">windowRole</span>() const</h3>
<p><font style="vertical-align: inherit;">返回窗口的角色，或一个空字符串。</font></p>
<p><b>请参考 </b><a href="qwidget.html#setWindowRole">setWindowRole</a>(), <a href="qwidget.html#windowIcon-prop">windowIcon</a>,
<span lang="zh-cn">和 </span><a href="qwidget.html#windowTitle-prop">windowTitle</a><span lang="zh-cn">。</span></p>
<!-- @@@windowRole -->
<!-- $$$windowState[overload1]$$$windowState -->
<h3 class="fn" id="windowState"><a name="windowState"></a><span class="type"><a href="../qtcore/qt.html#WindowState-enum">Qt::WindowStates</a></span> QWidget::<span class="name">windowState</span>() const</h3>
<p><font style="vertical-align: inherit;">返回当前窗口状态。窗口状态是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum"><font style="vertical-align: inherit;">Qt::WindowState</font></a><font style="vertical-align: inherit;"><span lang="zh-cn">(<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum">Qt::WindowMinimized</a>、<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum">Qt::WindowMaximized</a>、<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum">Qt::WindowFullScreen</a>和<a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowState-enum">Qt::WindowActive</a>)</span>的 OR 组合。</font></p>
<p><b>请参考 </b><a href="../qtcore/qt.html#WindowState-enum">Qt::WindowState</a> 
<span lang="zh-cn">和 </span><a href="qwidget.html#setWindowState">setWindowState</a>()<span lang="zh-cn">。</span></p>
<!-- @@@windowState -->
<!-- $$$windowTitleChanged -->
<h3 class="fn" id="windowTitleChanged"><a name="windowTitleChanged"></a><code>[signal] </code><span class="type">void</span> QWidget::<span class="name">windowTitleChanged</span>(const <span class="type"><a href="../qtcore/qstring.html">QString</a></span> &amp;<i>title</i>)</h3>
<p><font style="vertical-align: inherit;">当窗口的标题改变时发出这个信号，新</font><i><font style="vertical-align: inherit;">标题</font></i><font style="vertical-align: inherit;">作为参数。</font></p>
<p><font style="vertical-align: inherit;">这个函数是在 Qt 5.2 中引入的。</font></p>
<p><b><font style="vertical-align: inherit;">注意：</font></b><font style="vertical-align: inherit;">属性</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#windowTitle-prop"><font style="vertical-align: inherit;">windowTitle 的</font></a><font style="vertical-align: inherit;">通知程序信号。</font></p><!-- @@@windowTitleChanged -->
<!-- $$$windowType[overload1]$$$windowType -->
<h3 class="fn" id="windowType"><a name="windowType"></a><span class="type"><a href="../qtcore/qt.html#WindowType-enum">Qt::WindowType</a></span> QWidget::<span class="name">windowType</span>() const</h3>
<p><font style="vertical-align: inherit;">返回此组件的窗口类型。这与</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html#windowFlags-prop"><font style="vertical-align: inherit;">windowFlags</font></a><font style="vertical-align: inherit;"> () &amp; </font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qt.html#WindowType-enum"><font style="vertical-align: inherit;">Qt::WindowType_Mask 相同</font></a><font style="vertical-align: inherit;">。</font></p>
<p><b>请参考 </b><a href="qwidget.html#windowFlags-prop">windowFlags</a><span lang="zh-cn">。</span></p>
<!-- @@@windowType -->
</div>
<div class="macros">
<h2><span lang="zh-cn">宏文档</span></h2>
<!-- $$$QWIDGETSIZE_MAX[overload1]$$$QWIDGETSIZE_MAX -->
<h3 class="fn" id="QWIDGETSIZE_MAX"><a name="QWIDGETSIZE_MAX"></a><span class="name">QWIDGETSIZE_MAX</span></h3>
<p><font style="vertical-align: inherit;">定义</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtwidgets/qwidget.html"><font style="vertical-align: inherit;">QWidget</font></a><font style="vertical-align: inherit;">对象的最大尺寸。</font></p>
<p><font style="vertical-align: inherit;">组件允许的最大尺寸是</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qsize.html"><font style="vertical-align: inherit;">QSize</font></a><font style="vertical-align: inherit;"> (QWIDGETSIZE_MAX, QWIDGETSIZE_MAX)，即</font><a href="file:///E:/WLL/work/Qt5.12-Document-Trans-in-Chinese/qtcore/qsize.html"><font style="vertical-align: inherit;">QSize</font></a><font style="vertical-align: inherit;"> (16777215,16777215)。</font></p>
<p><b>请参考 </b><a href="qwidget.html#maximumSize-prop">QWidget::setMaximumSize</a>()<span lang="zh-cn">。</span></p>
<!-- @@@QWIDGETSIZE_MAX -->
</div>
        </div>
       </div>
   </div>
   </div>
</div>
<div class="footer">
   <p>
   <acronym title="Copyright">&copy;</acronym> 2019 The Qt Company Ltd.
   Documentation contributions included herein are the copyrights of
   their respective owners.<br/>    The documentation provided herein is licensed under the terms of the    <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation    License version 1.3</a> as published by the Free Software Foundation.<br/>    Qt and respective logos are trademarks of The Qt Company Ltd.     in Finland and/or other countries worldwide. All other trademarks are property
   of their respective owners. </p>
</div>
</body>
</html>
